Rate limits
How fast you can call the API.
Limits
Each client address can make up to 600 requests a minute. Checking a document with POST /verify is limited to 30 a minute.
Every response carries x-ratelimit-limit, x-ratelimit-remaining and x-ratelimit-reset. Over the limit you get 429 rate_limited with a Retry-After header in seconds.
Reminders have their own rule: one email to the same person per hour (429 reminder_too_soon).
Staying under the limit
- Use webhooks instead of polling for status changes.
- Use list filters (status, label, metadata) rather than fetching everything.
- Back off when you get 429, and spread bulk work over time.