Skip to main content
POST
/
v1
/
oauth
/
token
Issue a Token
curl --request POST \
  --url https://sandbox.api.fin.com/v1/oauth/token \
  --header 'Content-Type: application/json' \
  --data '
{
  "client_id": "<string>",
  "client_secret": "<string>"
}
'
{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "access_token_ttl": "2025-12-28 10:34:45+00",
  "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "refresh_token_ttl": "2025-12-28 10:34:45+00",
  "current_time": "2025-12-21 10:34:45+00"
}
Grab your client_id and client_secret from the API Keys section of the Orchestration Dashboard
The TTLs returned from this API are actually the time that the the token will expire; i.e. not validity in number of seconds since creation.
The timestamps, i.e. TTLs returned from this endpoint are NOT in ISO 8601 format. Rather it is in the format YYYY-MM-DD HH:MM:SS+00

Body

application/json
​
client_id
string
required

Client ID

​
client_secret
string<password>
required

Client Secret

Response

Token issued successfully

​
access_token
string

The access token for API authentication

Example:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

​
access_token_ttl
string<date-time>

Access token expiration timestamp

Example:

"2025-12-28 10:34:45+00"

​
refresh_token
string

The refresh token for obtaining new access tokens

Example:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

​
refresh_token_ttl
string<date-time>

Refresh token expiration timestamp

Example:

"2025-12-28 10:34:45+00"

​
current_time
string<date-time>

Current server timestamp

Example:

"2025-12-21 10:34:45+00"