Skip to main content
POST
/
oauth
/
token
curl -X POST https://api.cloud.blnkfinance.com/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -u "YOUR_CLIENT_ID:YOUR_CLIENT_SECRET" \
  -d "grant_type=refresh_token" \
  -d "refresh_token=blnk_rt_YOUR_REFRESH_TOKEN_HERE"

{
  "access_token": "blnk_at_...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "refresh_token": "blnk_rt_...",
  "scope": "data:read data:write proxy:write"
}

Documentation Index

Fetch the complete documentation index at: https://guide.cloud.blnkfinance.com/llms.txt

Use this file to discover all available pages before exploring further.

Refresh an expired access token using the refresh token you received when obtaining the original access token.

​
Request structure

curl -X POST https://api.cloud.blnkfinance.com/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -u "YOUR_CLIENT_ID:YOUR_CLIENT_SECRET" \
  -d "grant_type=refresh_token" \
  -d "refresh_token=blnk_rt_YOUR_REFRESH_TOKEN_HERE"
​
Authorization
string
required
Basic authentication using your OAuth client ID and client secret. Format: Basic base64(client_id:client_secret) or use -u flag in cURL.
​
grant_type
string
required
Must be refresh_token for this flow.
​
refresh_token
string
required
The refresh token received when obtaining the original access token.

​
Response structure

{
  "access_token": "blnk_at_...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "refresh_token": "blnk_rt_...",
  "scope": "data:read data:write proxy:write"
}
​
access_token
string
required
The new access token to use for authenticating API requests. Include in the Authorization: Bearer <access_token> header.
​
token_type
string
required
Always Bearer for access tokens.
​
expires_in
integer
required
Number of seconds until the access token expires.
​
refresh_token
string
required
A new refresh token. Use this token for future refresh requests.
​
scope
string
required
Space-separated list of scopes granted to this token.

​
Need help?

If you’re having trouble with Blnk Cloud, don’t hesitate to send us a message via email at support@blnkfinance.com or send us a message here.