API Reference

The AnonAge API is a small REST API over JSON. It covers everything you need to put an age gate on your site: open a verification session, receive the signed result, and report on your usage.

Base URLs

Environment	URL
Production (coming soon)	`https://api.anonage.io`
Development	`https://dev1api.anonage.io`

Response format

Every response uses the same envelope:

{
  "success": true,
  "data": {},
  "message": "…",
  "error": "…",
  "errors": []
}

Authentication

Header	Used for	Auth
`X-API-Key: anonage_sk_…`	Verification endpoints (`/api/age-verification/*`)	Your API key (server-side only)
`Authorization: Bearer <jwt>`	Usage and reporting endpoints	Account JWT from `/api/auth/login`

See Authentication for API keys.

Endpoint groups

Health — service status.
Auth — register, login, email verification, password reset.
Verification — open a session, poll a session (API key).
Usage — summary, by-key, session log, CSV export (business account).

AnonAge also sends you an outbound result callback when a verification completes — that is the signal your site should act on, rather than polling.

API keys are created and revoked in your Dashboard rather than through the API.

Error codes

Code	Meaning
400	Bad request — invalid input
401	Unauthorized — invalid/missing token or key
403	Forbidden — insufficient permissions (e.g. wrong account type)
404	Not found
409	Conflict — already exists (e.g. email taken)
410	Gone — session expired
422	Validation failed
429	Too many requests — rate limited
500	Internal server error

Rate limiting

Default: 100 requests / 15 min / IP.
Auth endpoints: 5 requests / 15 min / IP.
Webhooks: not rate limited.

New to the API? Start with the Quickstart.

Overview

Endpoints

Base URLs

Response format

Authentication

Endpoint groups

Error codes

Rate limiting

​Base URLs

​Response format

​Authentication

​Endpoint groups

​Error codes

​Rate limiting

Base URLs

Response format

Authentication

Endpoint groups

Error codes

Rate limiting