recalled.dev
Reference

Rate limits

Two buckets apply to /v1/*:

Per-key ingest limit

POST /v1/events: 1200 requests per minute per API key (default). When exceeded, the server returns 429 RATE_LIMITED.

This limit is generous because ingest is the hot path. Upgrade your plan or contact support if you regularly hit it.

Global IP limit

All other endpoints: 1500 requests per minute per IP. Same 429 response shape.

Response headers

We return standard IETF RateLimit headers on every response:

text
RateLimit-Limit: 1200
RateLimit-Remaining: 973
RateLimit-Reset: 45

Use them to back off gracefully. The SDK does automatic exponential backoff on 429.