Get access token
To successfully send requests, REST API requires an access token (Session ID) obtained by authentication. Simply pass the Refresh Token to the below REST resource to exchange it for an Access Token (Session ID) as shown below.
curl POST 'https://{domain}/api/3.0/token'
-H 'Content-Type: application/json'
-H 'Accept: application/json'
-d '{
"grant_type": "refresh_token",
"refresh_token": "{api key}"
}'
Request Body
grant_type string Required
Indicates that an access token is requested or renewed using an existing refresh token (in this case, the provided API key). In this implementation, the same endpoint is used both for the initial token request and for subsequent renewals, ensuring continued access without requiring additional authentication.
refresh_token string Required
This is the unique token (API key) you provide at the token endpoint to obtain or renew your access token. By including your refresh_token in the request body, the system can verify your credentials and issue a valid access token, ensuring uninterrupted access to the API.
Sample success response
HTTP 200 OK
{
"token": "{sid}",
"dateIssued": "{issueDate}",
"validUntil": "{validUntilDate}",
"success": true,
"errors": []
}
Note:
Date Format is UTC ISO 8601 with the following format: YYYY-MM-DDTHH:MM:SS.ssssssZ
example: 2025-11-21T21:25:28.058323Z
Sample failed response
HTTP 403 Forbidden
{
"token": null,
"dateIssued": "2019-11-22T18:34:50.4506867Z",
"validUntil": null,
"success": false,
"errors": [
{
"code": "INVALID_SCOPE",
"fieldName": null,
"message": "Login failed."
}
]
}
What's Next?