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=authorization_code" \
  -d "code=THE_CODE_FROM_REDIRECT" \
  -d "redirect_uri=https://your-app.com/oauth/callback"

{
  "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.

Exchange an authorization code for an access token. Use this endpoint after the user authorizes your app and you receive an authorization code.

​
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=authorization_code" \
  -d "code=THE_CODE_FROM_REDIRECT" \
  -d "redirect_uri=https://your-app.com/oauth/callback"
​
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 authorization_code for this flow.
​
code
string
required
The authorization code received from the OAuth redirect after user authorization.
​
redirect_uri
string
required
The redirect URI that was used in the authorization request. Must match exactly.

​
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 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
Token used to obtain a new access token when the current one expires.
​
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.