Beschrijving
API to access the tools endpoints of developer.overheid.nl.
Auth
This API provides tools endpoints that can be accessed with either an API key or a client credentials token.
API key
Using an API key, you can access the tools endpoints.
These requests can also be made from the browser.
Request a read-only API key at https://apis.developer.overheid.nl/apis/key-aanvragen.
Simply pass the obtained API key with each request using the X-Api-Key header.
Client credentials token
Using a client credentials token, you can access the tools endpoints.
To obtain the token, perform a POST request to https://auth.developer.overheid.nl/realms/don/protocol/openid-connect/token with the following Form URL Encoded body:
grant_type:client_credentialsscope:toolsfor the tools endpoints;events:readand/orevents:writefor the events endpointsclient_id: the client id you received from usclient_secret: the client secret you received from us
Pass the obtained token with each request using the Authorization header. Example:
Authorization: Bearer {ACCESS_TOKEN} (replace {ACCESS_TOKEN} with the obtained access_token)
Events
Reading events (GET) is possible with an API key or with a client credentials token with scope events:read.
Creating, changing and deleting events (POST, PUT, DELETE) requires a client credentials token with scope events:write.
Events harvested from Pleio can only be changed at the source; deleting such an event hides it from the agenda.
Pagination
Pagination of collections is done using the Link header.
Additionally, the headers Current-Page, Per-Page, Total-Count and Total-Pages provide extra support for implementing pagination in the client.
Dates and times
All moments in time are RFC 3339 date-times with a UTC offset, e.g. 2026-10-06T15:30:00+02:00.