Skip to main content
500CallsDocs
Browse the docs

insufficient_balance

Insufficient balance

HTTP status
402
Code
insufficient_balance
Retry?
Yes, after you top up

What it means

Your available balance does not cover the most this request can cost. Nothing was accepted: the recipients are refused together, never some of them.

What to do

Top up by at least required_amount minus available_amount, both in the response, or send to fewer recipients.

Example

Example 402 response
{  "type": "https://docs.messaging.500calls.com/errors/insufficient_balance",  "title": "Insufficient balance",  "status": 402,  "code": "insufficient_balance",  "detail": "This request needs a hold of NGN 3.5000 but your available balance is NGN 1.2000. No messages were accepted.",  "request_id": "req_01M3KR6CQ26S90NG2V790GVFTX",  "errors": [],  "available_amount": "1.2000",  "currency": "NGN",  "required_amount": "3.5000"}

Returned by

How errors work