GET https://app.ageonce.com/verify?client_id=...&redirect_uri=...&state=...

POST https://app.ageonce.com/api/oauth/token

{
  "client_id": "string",
  "client_secret": "string",
  "code": "string",
  "redirect_uri": "string"
}

{
  "age_token": "string",
  "token_type": "Bearer",
  "expires_in": 600,
  "transaction_id": "uuid"
}

POST https://app.ageonce.com/api/oauth/validate

{
  "token": "string"
}

{
  "valid": true,
  "payload": {
    "sub": "anonymous",
    "age_verified": true,
    "min_age": 18,
    "verification_id": "uuid",
    "verified_at": "2026-02-11T12:00:00Z",
    "client_id": "string",
    "iat": 1739275200,
    "exp": 1739361600,
    "iss": "ageonce"
  }
}

GET https://app.ageonce.com/api/oauth/jwks

{
  "keys": [
    {
      "kty": "RSA",
      "kid": "ageonce-public-key",
      "use": "sig",
      "alg": "RS256",
      "n": "...",
      "e": "AQAB"
    }
  ]
}

GET https://app.ageonce.com/api/stats/usage
Authorization: Bearer <session_token>

{
  "period": "month",
  "total_verifications": 1250,
  "successful": 1180,
  "failed": 70,
  "daily_breakdown": [
    { "date": "2026-02-01", "count": 45 },
    { "date": "2026-02-02", "count": 52 }
  ]
}

{
  "error": "error_code",
  "error_description": "Human readable description"
}