Authorization

Download OpenAPI specification:Download

Obtain client access tokens for API authorization when needed (see Authentication). Click Try it from the API explorer below to generate access tokens directly from the docs. You can then use these tokens to run API requests in this API reference.

Get client access token

Retrieve an access token to authorize your API request. By default, the access token is valid for 1 hour, you don't need to regenerate it every time before calling Mosaic APIs.

NOTE: The request type and examples depend on the service you choose

Request
Request Body schema: application/x-www-form-urlencoded
required
One of:
client_id
required
string

Client identifier

client_secret
required
string

Client secret

grant_type
required
string

Should be set to client_credentials.

Value: "client_credentials"
resource
string

URI of the resource the request is attempting to access.

Value: "https://verify.identity.security"
Responses
200

Access token successfully retrieved

400
500
post/oidc/token
Request samples
application/x-www-form-urlencoded
client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&grant_type=client_credentials&resource=https%3A%2F%2Fverify.identity.security
Response samples
application/json
{
  • "access_token": "string",
  • "token_type": "Bearer",
  • "expires_in": 3600,
  • "scope": "string"
}