Errors and limits
Every error has the same shape and a stable code to branch on.
{ "error": { "code": "invalid_request", "message": "Phone must be a 10-digit Indian mobile number.", "requestId": "853f9c091e12c4fac75aa86c" } }codeis stable: branch on it.messageis for people and may be reworded.requestIdis also in theX-Request-Idheader of every response. Quote it to us.
Codes
| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_request | Something in your request is missing or wrong. The message says what. |
| 401 | unauthorized | The key is missing, wrong or revoked. |
| 402 | payment_required | The wallet is empty or there is no active plan. Add credit and try again. |
| 403 | forbidden | The account is switched off. |
| 403 | insufficient_scope | A read-only key was used to change something. Use a key with full access. |
| 404 | not_found | No such lead, call, campaign or conversation in your account. |
| 409 | conflict | Not allowed right now: outside 9 am to 9 pm, the person is on the do-not-call list, all lines are busy, or the campaign is in the wrong state. |
| 413 | too_large | The request is too big. |
| 429 | rate_limited | Too many requests. Wait the number of seconds in the Retry-After header. |
| 429 | too_many_calls_to_number | The same person already had 3 calls in 24 hours. |
| 429 | daily_call_limit_reached | You placed 1,000 calls in 24 hours. Ask us to raise it if you need more. |
| 500 | server_error | Our fault. It is safe to retry with the same Idempotency-Key. Quote the requestId to us. |
Rate limits
| Requests | 120 a minute for each key. |
|---|---|
| Calls through the API | 1,000 in 24 hours for your account. |
| Calls to one person | 3 in 24 hours. |
| People in a campaign | 1,000 per request and 20,000 in a campaign. |
Every answer carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset (a Unix time). Over the limit you get 429 with Retry-After in seconds.
What to retry
Retry 429 and 500 after a pause, always with the same Idempotency-Key. Do not retry other 4xx errors without fixing the request.
Last updated 13 November 2026. Found something wrong on this page? Email bodavulasiddardha@navaprastha.in and we will correct it.