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.
All URLs referenced in MessageBird's Balance Messaging API documentation have the base URL in the code snippet on the right side:
The MessageBird API uses HTTP verbs to understand if you want to read (GET), delete (DELETE) or create (POST) an object. When your web application cannot do a POST or DELETE, we provide the ability to set the method through the query parameter _method.
This object represents your balance at MessageBird.com
|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.