post https://api.sandbox.usebasis.co/oauth/token
Implements the /token
endpoint as defined in OAuth2.1.
Authentication
This endpoint uses Basic authentication. Base64 encode your client_id
and client_secret
, separated by a colon (:), and include it in the Authorization
header of your request.
Authorization: Basic Base64(client_id:client_secret)
Grant Types
- When exchanging an authorization
code
for anaccess_token
andrefresh_token
upon completion of an OAuth flow (e.g. User has authorized your Client to access their Profile), use theauthorization_code
grant type. - When acquiring an
access_token
with yourclient_id
andclient_secret
, use theclient_credentials
grant type. The acceptable scopes areinstitutions:read
andprofiles:read
. - When acquiring a new
access_token
for a specific profile using arefresh_token
, use therefresh_token
grant type. The only acceptable scope isprofile:read
.