WatificationDocs

API request rate exceeded

This API key exceeded the shared request rate limit.

Code
RATE_LIMITED
HTTP status
429

What to do now

  1. Wait at least the Retry-After delay, currently one second, and add jitter before retrying. Reduce polling and prefer webhooks.

Why this happens

  • OTP and COD requests, including reads and idempotent repeats, share a limit of 20 requests per second per key.

Before you retry

Honor Retry-After as a minimum delay and add jitter. Keep the same POST body and idempotency key when retrying the same operation.

Related reference

On this page