Authorization for Prove endpoints is performed using an OAuth 2.0 bearer token. To generate a bearer token for the Sandbox environment, follow these steps:

1

Access your Developer Portal account

Login to the Developer Portal.

2

Navigate to the Prove solution

Navigate to Projects from the side bar.

3

Create a project

Select the appropriate solution, give your project a name, and then select Create Project.

4

View Credentials

Select your project to access your credentials.

5

Test Your Credentials Using cURL

Use the following example cURL request for the /token endpoint, to generate a bearer token. Replace the placeholders with your actual credentials.

Request Bearer Token
curl -X POST https://platform.uat.proveapis.com/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
Response
{
  "access_token": "eyJ...",
  "refresh_token": "eyJ...",
  "refresh_expires_in": 3600,
  "token_type": "Bearer",
  "expires_in": 3600
}
6

Authenticate a Request

Use the bearer token in the Authorization header of your requests, replacing the placeholder with your bearer token:

curl -X POST https://platform.uat.proveapis.com/v3/start \
  -H 'Authorization: Bearer YOUR_BEARER_TOKEN' \
  -H 'Content-Type: application/json' \
  -d "phoneNumber=2001001695&flowType=mobile"

Prefer Postman? Check out Prove’s API collection to try out different endpoints with preconfigured test data.