Using Legacy Mandates
This API and GUI is being deprecated in favour of the Developer Documentation: Using the Purpose Registry.
Mandates
Data can only be retrieved from JoinData if the owner of the data (the farmer) has given permission to the retrieving company to retrieve this data. This permission is called a mandate. Mandates are set between companies. There is an Authorizing Company, the farmer, and a Authorized Company, the application owner. These companies are identified by their company key, for the Netherlands this is the chamber of commerce number (nl-v1 scheme). A mandate is given for a data set, a group of data types which can be queried based on that mandate. For each set a separate mandate is required, though commonly these are bundled in a single purpose (see Component – Purpose Registry). To see which data sets contain which data types, see our Data Catalog.
Requesting a mandate
This API is deprecated in favor of the Purpose Registry.
A mandate can be requested in two ways, via the Mandates API and via Mandates-app.
Mandates API
Mandates can be requested using the POST and PUT mandates end-point of the Mandates API. In the API-docs the working of this end-point is described.
Mandates-app
- The mandates-app can be found here for the integration environment and here for production environment.
- As a application developer you can login using eHerkenning. The eHerkenning-account should be registered to the company that owns the application.
- After logging in you will see an overview of the requested (‘ingediende aanvragen’) or granted mandates (‘aan u verleende machtigingen’)
- By pressing the ‘Nieuw’ (New) button, a new mandate can be requested
- Fill in the form
- Fill in the authorising company, i.e. farmer (‘Vertegenwoordige’)
- The authorised company, i.e. the application owner is already prefilled (‘Gemachtigde’)
- The providing company is always JoinData (‘Leverancier’)
- Choose the data-set, describe the purpose limition (‘Machtigingsdoel’) and give in a starting date (‘Begindatum’). The end date (‘Einddatum’) is optional. Finally you should select the purpose with the checkboxes: Research (‘Onderzoek’), Technical reporting (‘Technische Rapportage’), Financial reporting (‘Financiele rapportage’), Benchmark, certification (‘Certificatie’).
- Confirm with the ‘Opslaan’ button.
- The authorising company will now recieve a request to confirm the mandate. They can login on the mandates-app using eHerkenning and confirm the mandate.
Notice on mandates-app
The mandates-app is subject to change. It is possible the lay-out of the application changes.