Retrieve your message credit balance

Returns the message credit left on one of your numbers, in your wallet's currency (INR or USD). Each number has its own wallet; top it up on the dashboard under Messaging → WhatsApp → Credit.

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 your team's API plan has lapsed or the number is suspended, so you can always see what credit is left.

Path ParametersCopy Anchor Link

Response BodyCopy Anchor Link

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}