Obtain a Refresh and Access Tokens

This endpoint supports two key operations:

  • Obtain an initial Refresh Token by passing grant_type: "client_credentials" together with your client_id and client_secret. The response will contain the initial Refresh Token and an Access Token.
  • Renew Access Token by passing grant_type: refresh_token using a valid Refresh Token next to your client_id. The Refresh token, used in the request, will be invalidated.
Request
Request Body schema: application/json

Request Access Token

grant_type
required
string
Enum: "client_credentials" "refresh_token"
client_id
required
string
client_secret
string

required if the grant_type is client_credentials

refresh_token
string

required if the grant_type is refresh_token. Pass a valid Refresh token.

Responses
200

Success Response

413

Error

422

Error

429

Too Many Requests

500

Error

post/v1/oauth/token
Request samples
application/json
{
  • "grant_type": "client_credentials",
  • "client_id": "partner",
  • "client_secret": "secret12345",
  • "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnRJZCI6Imx5ZGlhIiwiZXhwIjoxNjY0MDIzMzkyLCJuYmYiOjE2NjM5MzY5OTIsImlhdCI6MTY2MzkzNjk5MiwianRpIjoiY2UxZmFjMDEtNDhjZC00NWE4LWI3YjQtYTA2NDQxZTUwZWE4In0.ZYafj15LT5hrFXzWjtzZci1yvL9INKyv85FeGxUaRfE"
}
Response samples
application/json
{
  • "expires_in": 600,
  • "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnRJZCI6Imx5ZGlhIiwiZXhwIjoxNjYzOTM3NTkyLCJuYmYiOjE2NjM5MzY5OTIsImlhdCI6MTY2MzkzNjk5MiwianRpIjoiMTc2NzM0Y2ItYjVmOC00OGFkLTlhMDMtYzRkYjYxZjQwM2I1In0.e-exoz0u-xyE7wN8I3vQwnXSP98Jekh3-7Fo_UrzDKqw9bfZ38kbLndsZXbXpdgqT1eziOg_TVx27St8f3EeBKUg_vCPfJrlPFMXJCVjWwEXg2E1a1cQJWbgdY4PudBF68R4bUUTHpstjD6zufxj5rRERG-6iDhc-xNuBw-IdFaYeJO8-upWJEtt-p23FlpiH4RkflXoxqpP-oWc22aGyAJdMWWY_IIOPCFn3w4f7LhBhh8AWpAbwnTl1ZgFCH1kq3QncBvbRHuqN7UYPlpon_ygBpae6xhYbsBtmfDNnZacZ7-HABLwe3rTJlGw5ltAl_OeB3sq_wAmrJuF4L56OA",
  • "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjbGllbnRJZCI6Imx5ZGlhIiwiZXhwIjoxNjY0MDIzMzkyLCJuYmYiOjE2NjM5MzY5OTIsImlhdCI6MTY2MzkzNjk5MiwianRpIjoiY2UxZmFjMDEtNDhjZC00NWE4LWI3YjQtYTA2NDQxZTUwZWE4In0.ZYafj15LT5hrFXzWjtzZci1yvL9INKyv85FeGxUaRfE"
}