Skip to main content
POST
Exchange Link Code for login_identity_token and login_identity_id

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/x-www-form-urlencoded
grant_type
enum<string>
required

Accepted values: authorization_code

Available options:
authorization_code
code
string
required

Use code URL parameter returned to Customer App's redirect URI

client_id
string
required

See API credentials. Managed on Finverse developer dashboard (dashboard.finverse.com)

redirect_uri
string
required

Must match the redirect_uri associated with the Customer App. Managed on Finverse developer dashboard (dashboard.finverse.com)

Response

Service Okay

access_token
string
required

(SENSITIVE) Login Identity access token (referred to as login_identity_token).

expires_in
integer<int64>
required

Access token validity length (in seconds).

issued_at
string<date-time>
required

Access token issue time

login_identity_id
string
required

Finverse Login Identity ID for this Login Identity. Always unique. Linking the same account at the same institution twice will result in two Login Identities with different IDs (use Refresh/Relink methods to refresh data for a Login Identity without updating the ID).

refresh_token
string
required

(SENSITIVE) Login Identity refresh token (referred to as login_identityrefresh_token)

token_type
string
required

Possible values: Bearer