latestOpenAPI 3.1.02026-08-1557182178.2 KB

85518ccab2aa

billing

Get billing status

Returns the account's credit-wallet balance, the current subscription (if any), each phone number's billing mode (PAYG or FIXED), and recent usage.

get/api/v1/billing

Headers

Authorizationstring required

Your Dial API key, sent as Authorization: Bearer sk_live_...

Response

Billing status.

balanceCentsinteger

Credit-wallet balance in USD cents. May be negative.

numbersReleaseAtstring date-time nullable

When all of the account's numbers will be released for non-payment, or null when nothing is at risk. Non-null only for a pay-as-you-go account whose balance is negative: it's the end of the 30-day grace period (measured from when the balance first went negative). Topping the balance back to zero or above clears it. Subscription-covered accounts are never at risk, so this is always null for them.