v1

latestOpenAPI 3.0.32026-07-235367171.5 KB
OAuth2

Creates and renews AccessTokens

This API implements rfc7009, rfc7636 and rfc6749

post/v1/access_tokens

Request body

grant_type'authorization_code' | 'refresh_token' | 'client_credentials' required

Grant Type.

codestring

Authorization code that the client previously received from the authorization server. Required when grant_type is authorization_code.

redirect_uristring

The redirect URI in the token request must be an exact match of the redirect URI that was used when generating the authorization code. Required for when grant_type is authorization_code.

refresh_tokenstring

Refresh token that the client previously received from the authorization server. Required when grant_type is refresh_token.

client_idstring required

Client ID used for authentication.

client_secretstring

Client Secret used for authentication, only used in Server-Side Apps

code_verifierstring

Code verifier(PKCE), only used in Mobile and Native Apps

client_assertionstring

Only used with the combination of client_credentials grant_type and client_assertion_type

client_assertion_type'urn:ietf:params:oauth:client-assertion-type:jwt-bearer'

Only used with the combination of client_credentials grant_type and client_assertion

Response

Success

validity_start_datestring

Date and Time in ISO8601 format example: '2018-11-06T10:20:37.094533Z'

validity_end_datestring

Date and Time in ISO8601 format example: '2018-11-06T10:20:37.094533Z'

token_typestring required

Token type

scopestring

List of scopes

refresh_tokenstring

Refresh token should be used after the access token is expired to fetch a new access token

expires_ininteger required

Expiration time in seconds

authorization_idstring

Authorization Id could be used later on in authorization_changed Webhook

access_tokenstring required

Access token

status'pending' | 'approved'

In BMW and MINI case, the status is pending until the car owner grants access in BMW ConnectedDrive Portal

All 5 operations