Retrieve your message credit balance

Returns the message credit left on the number your key is for, in your wallet's currency (INR or USD). Each number has its own wallet; top it up on the dashboard on the number's Credit page.

The balance is refreshed at most once a minute, so polling faster returns the same value. updated_at says when it was last read.

It works even when the number's API plan has lapsed or the number is suspended, so you can always see what credit is left.

curl -X GET "https://wa.hostmentor.com/v3/106540352242922/balance" \  -H "apikey: YOUR_API_KEY"

{  "phone_number_id": "106540352242922",  "currency": "INR",  "balance": {    "value": 153000,    "offset": 100  },  "updated_at": "2026-09-30T10:00:00.000Z",  "stale": false}