Endpoints

Identify the calling Master Account

Returns the Master Account id and the credential id your bearer token maps to. Carries no token material. This is the natural smoke test for the whole authentication path.

GET
/v1/whoami

Authorization

bearerAuth
AuthorizationBearer <token>

A partner API token issued to a Master Account. Send Authorization: Bearer <token> on every request. Tokens are issued and revoked by a SuperAdmin in the backoffice, not through this API.

In: header

Response Body

application/json

application/json

application/json

{
  "masterid": 42,
  "tokenid": 7
}
{
  "error": {
    "code": "unauthorized",
    "message": "A valid bearer token is required.",
    "requestid": "8f3c1a9b2d7e4f60"
  }
}
{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests. Retry after the period indicated.",
    "requestid": "8f3c1a9b2d7e4f60"
  }
}

On this page