MessageBird's Balance API allows you to retrieve your total balance and balance information from your account, such as currency and type of payment (prepaid, postpaid).
You can use the Balance API to expose this information in one of your app or internal dashboards, as well as to send notifications.
The Balance API uses HTTP verbs and a RESTful endpoint structure with an access key that is used as the API Authorization framework. Request and response payloads are formatted as JSON—although we provide a GET alternative for requests—using UTF-8 encoding and URL encoded values.
This object represents your balance at MessageBird.com
Attribute | Type | Description |
---|---|---|
payment | string | Your payment method. Possible values are: prepaid & postpaid |
type | string | Your payment type. Possible values are: credits, euros, pounds & dollars. For all other supported currencies, an ISO-4217 code is returned. |
amount | float | The amount of balance of the payment type. When postpaid is your payment method, the amount will be 0. |
Returns a balance object if the request was successful. If the request failed, an error object will be returned.