Rate Limits

API requests are rate limited per API key, per endpoint group:

Endpoints	Limit
GET /v1/balance · GET /v1/tasks/{token} · GET /v1/tasks/{token}/result	120 requests / minute
POST /v1/detect · POST /v1/detect/file	30 requests / minute
POST /v1/realtime/check/phone	Token bucket: 180 requests/minute pre-auth limit plus burst control. Every realtime response carries an X-RateLimit-Remaining header.

When you hit a 429

When a limit is exceeded the API returns 429 with a Retry-After header (realtime responses also include a retry_after field). Stop sending requests for the indicated number of seconds, then resume with exponential backoff.