Skip to content

User - Authentication ​

Overview ​

Authenticates a CBD account and returns the authorization token used by the protected endpoints of the ABS Clearing-House API. CBD accounts are shared across the clearing houses, so this call takes no realm.

Endpoint ​

POST /api/v2013/authentication/token

Request Body ​

FieldTypeDescription
emailStringYour registered CBD account email address.
passwordStringYour CBD account password.

Using the Token ​

A successful call returns the token and its expiration:

json
{
  "authenticationToken": "<AUTHENTICATION TOKEN>",
  "expiration": "2024-07-17T02:01:54.2274392Z"
}

Send it as a bearer token in the Authorization header of subsequent requests:

Authorization: Bearer <AUTHENTICATION TOKEN>

Invalid credentials are rejected with 403 Forbidden and an empty response body.

Tokens are environment-specific: this site targets https://api.cbd.int, and a token issued there is not valid on the other environment.

Playground ​

Swagger playground is loading, please wait...