OAuth Tenant Authentication

• Api Key
• Access Token

📘

No credentials yet?

Contact us to request access to the Zonnedimmer Smart Solar API

API Key

During the setup process, we will provide your unique API key.

The API Key should be included as a header in every request to the Smart Solar API:

curl -X GET 'https://app.zonnedimmer.nl/api/v1/ssa' \
    --header 'ApiKey: {YOUR API KEY}' \

Access Token

Bearer Access Tokens are used for tenants to access resources and perform actions in the Smart Solar API.

Obtaining a Bearer Access Token is as easy as providing your client_id and client_secret (i.e. your client credentials) to the token endpoint as illustrated below.

🚧

Keep your client credentials secret

Your client_id and client_secret provide access to the data and assets in your portfolio. Never share these credentials in any place where others might get access to these credentials, like cloud repositories or client-side code.

Example request:

curl -X POST 'https://app.zonnedimmer.nl/api/v1/ssa/oauth/token' 
		 --header 'Content-Type: application/x-www-form-urlencoded' \
		 --header 'ApiKey: {YOUR API KEY}' \
		 --data-urlencode 'grant_type=client_credentials' \ 
		 --data-urlencode 'client_id={your client_id}' \ 
		 --data-urlencode 'client_secret={your client_secret}'
		 --data-urlencode 'scope=pvcurtailment'\

Example response:

{
    "access_token": "VOx95XwcqihYfKdBxFFzCD9pUbozf83DYGQDKub2mGs3Omy1xHyrTSJ2EUi6nHay",
    "expires_in": "2025-11-19T00:24:25.703466Z",
    "token_type": "pvcurtailment"
}

📘

Token expiration

A Tenant Access Token is valid for 14 days or as long as specified (expires_in in seconds). You should store/cache the token until it expires and request a new access token using the endpoint above, before it expires.