Skip to main content
GET
/
oauth
/
authorize
Authorize
curl --request GET \
  --url https://manage.mijnklantportaal.nl/oauth/authorize
Please note that the base URL for this endpoint is: https://manage.mijnklantportaal.nl

​
Query parameters

​
client_id
string
required
ID of your application you got after registering it in the Developer portal.
​
redirect_uri
string
required
The URL where the user should be send to after accepting or declining the permission request.
The URL must be registered with your application in the Developer portal.
​
state
string
required
A random string generated by your application to prevent CSRF attacks. This value will be returned in the redirect back to your application.
​
scope
string
required
A, with spaces separated, string with the OAuth Scopes you want access to.Example: customers.read customer.write invoices.read
​
prompt
string
default:"consent"
Can be consent or login.
​
response_type
string
required
The type of response you want to return. This should always be code.

​
Response

The user decides to accept or reject your request. After that, we send the user back to your redirect_uri and include some information for your application. We add some query parameters to your URL: In case of an approval:
​
code
string
The Authorization code which you need to exchange for the actual Access and Refresh tokens.
This code is valid for just a short amount of time. Exchange it as soon as you get it.
​
state
string
The string you set upon request. You have to check if the string matches the one you have set to ensure CSRF protection.
In case of a rejection or error:
​
error
string
The error code.
​
error_description
string
A human-readable description of the error occured.