Skip to main content
POST
Acquire Access Token
Credentials must be requested in order to generate an Authentication token needed to use the Ramp API. Contact Ripio support to request the partner’s registration and obtain client_id and client_secret, which univocally identify you as a Ripio customer. It is the partner’s responsibility to secure these credentials.

Authorizations

Authorization
string
header
required

Use Basic Auth with base64 encoded client_id:client_secret.

Body

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

Must be 'client_credentials'

Available options:
client_credentials

Response

Access token granted successfully.

Standard OAuth 2.0 token response. Note the fields are in snake_case, unlike the rest of the API, which uses camelCase.

access_token
string
required

The access token to be used for subsequent API calls.

Example:

"UfpqHJaQEjV27rR6itJyhUz5x6eOxz"

expires_in
integer
required

The expiration time for the access token in seconds.

Example:

36000

token_type
string
required

The type of token issued (always "Bearer" for this flow).

Example:

"Bearer"

scope
string

The scope of access granted by the token.

Example:

"read write"