Getting Started

This guide walks your business through the fastest path to a working CAIRL integration.

Prerequisites

• A CAIRL business account
• API credentials (available in your dashboard under Settings > API Keys)
• A redirect URI for OAuth callbacks

1. Register your application

Register your application in the CAIRL dashboard to receive your client_id and client_secret.

# Your credentials will look like this:
CAIRL_CLIENT_ID=your_client_id
CAIRL_CLIENT_SECRET=your_client_secret

2. Initiate the verification flow

Redirect users to the CAIRL authorization endpoint with the claim scopes your business requires.

GET https://cairl.app/oauth/authorize
  ?client_id=your_client_id
  &redirect_uri=https://yourapp.com/callback
  &response_type=code
  &scope=age_verification identity_confirmation

3. Handle the callback

After the user completes verification and authorizes sharing, CAIRL redirects back to your application with an authorization code.

POST https://cairl.app/oauth/token
  client_id=your_client_id
  &client_secret=your_client_secret
  &code=authorization_code
  &grant_type=authorization_code

4. Receive verified claims

The token response includes the verified claims your business requested.

{
  "access_token": "...",
  "verified_claims": {
    "age_over_18": true,
    "identity_confirmed": true,
    "certification_level": "verified"
  }
}

Your systems receive the claim. The personal data that produced it stays on CAIRL's side of the boundary.

Next steps

• Display the CAIRL trust badge on your platform
• Review brand usage requirements for referencing CAIRL
• Read the asset policy for distribution rules