Skip to main content
POST
/
v1
/
oauth
/
refresh-token
Refresh a Token
curl --request POST \
  --url https://sandbox.api.fin.com/v1/oauth/refresh-token \
  --header 'Content-Type: application/json' \
  --data '
{
  "refresh_token": "<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"
}
Exchanges a refresh_token received from the Issue Token endpoint for a new pair of access_token and refresh_token
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
​
refresh_token
string
required

The refresh_token received from the /v1/oauth/token endpoint.

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"