BeaconBox
Esc

Type to search.

Dashboard

Get the balance

The prepaid balance shared by SMS and WhatsApp, and whether it is running low.

GET/api/v1/credits

Request

curl https://api.beaconbox.eu/api/v1/credits \
  -H "Authorization: Bearer $BEACONBOX_API_KEY"

Response

Returns 200.

FieldTypeDescription
balanceintegerMessage credits remaining. One credit sends one message on whichever channel carries it; a single balance covers SMS today and WhatsApp when that channel opens.
low_balancebooleanTrue below the low-balance threshold. SMS stops at zero; email is unaffected.
thresholdinteger

Errors

Failures are { "error_code": "..." } with a stable dotted code. See Errors for the codes worth branching on and the three outcomes that look like failures and are not.