Fetch an Access Token

💡 Follow these steps to retrieve your access token.

Overview

An access token is a string that allows a user to access APIs and make an API call. To retrieve the access token, you must set oauth2_url and api_key. For details, take a look at the table below:

Attributes	Required	Description
oauth2_url	Yes	The Oauth2 endpoint base URL from the IDKit developer module.
api_key	Yes	The API key from the IDKit developer module.

📘

Note:

See how to obtain the oauth2_url and api_key here.

Request an Access Token

With the URL and the API key, you can request an access token. Pass your API key via the Authorization header (type: Basic).

An example of JSON body of the request

curl --location -g --request POST '{{oauth2_url}}/oauth2/token?grant_type=client_credentials&scope=transactions/get' \
--header 'Authorization: Basic {{api_key}}' \
--header 'Content-Type: application/x-www-form-urlencoded'

Here's what a successful JSON response should look like:

Example of Response

{
  "access_token":"eyJr [SNIP] z_Q",
  "expires_in":3600,
  "token_type":"Bearer"
}

❗️

Caution!

An access_token is only valid for 60 minutes.

💬 We Are Here to Help!

If you encounter an issue, a bug, or require assistance, please contact our support page here to find the solution. Don't forget to provide any important information on the issue.