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"
}
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?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool. To ask questions or discuss issues, please contact us or join our Discord community.