Docs menu

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" } }
  • code is stable: branch on it. message is for people and may be reworded.
  • requestId is also in the X-Request-Id header of every response. Quote it to us.

Codes

StatusCodeMeaning
400invalid_requestSomething in your request is missing or wrong. The message says what.
401unauthorizedThe key is missing, wrong or revoked.
402payment_requiredThe wallet is empty or there is no active plan. Add credit and try again.
403forbiddenThe account is switched off.
403insufficient_scopeA read-only key was used to change something. Use a key with full access.
404not_foundNo such lead, call, campaign or conversation in your account.
409conflictNot 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.
413too_largeThe request is too big.
429rate_limitedToo many requests. Wait the number of seconds in the Retry-After header.
429too_many_calls_to_numberThe same person already had 3 calls in 24 hours.
429daily_call_limit_reachedYou placed 1,000 calls in 24 hours. Ask us to raise it if you need more.
500server_errorOur fault. It is safe to retry with the same Idempotency-Key. Quote the requestId to us.

Rate limits

Requests120 a minute for each key.
Calls through the API1,000 in 24 hours for your account.
Calls to one person3 in 24 hours.
People in a campaign1,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.