Skip to main content

Authorization

Get initial tokens

For your first time you will get the tokens from us.

Request a refreshed Access Token

Access tokens are deliberately set to expire after a time (1 year), after which new tokens may be granted by supplying the refresh token originally obtained during the authorization code exchange.

In order to refresh the token, a POST request must be sent with the following body parameters encoded in application/x-www-form-urlencoded:

PARAMETERVALUE
grant_typeRequired Set it to refresh_token.
refresh_tokenRequired The refresh token returned from the authorization code exchange

The headers of this POST request must contain the following parameters:

HEADER PARAMETERVALUE
Content-TypeRequired Always set to application/x-www-form-urlencoded.

The response will be similar to this:

200 OK
{
"api_key": "YcwzJ...rlBN4",
"api_refresh": "8mdtH...hnbek",
"expires_on": "1720648800",
"token_type": "Bearer",
"expires_in": 31536000
}