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 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 Issue a token endpoint.

Response

Token issued successfully

​
access_token
string
Example:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

​
access_token_ttl
string<date-time>
Example:

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

​
refresh_token
string
Example:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

​
refresh_token_ttl
string<date-time>
Example:

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

​
current_time
string<date-time>
Example:

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