Balance API

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.

URI

https://rest.messagebird.com/balance

Available HTTP Methods

GET /balance

The balance object

This object represents your balance at MessageBird.com

Attributes

AttributeTypeDescription
paymentstringYour payment method. Possible values are: prepaid & postpaid
typestringYour payment type. Possible values are: credits, euros, pounds & dollars. For all other supported currencies, an ISO-4217 code is returned.
amountfloatThe amount of balance of the payment type. When postpaid is your payment method, the amount will be 0.

Object example

{
"payment": "prepaid",
"type": "euros",
"amount": 103
}

Get your balance

Retrieves your MessageBird balance.

Example request

curl -X GET https://rest.messagebird.com/balance -H 'Authorization: AccessKey test_gshuPaZoeEG6ovbc8M79w0QyM'

Returns

Returns a balance object if the request was successful. If the request failed, an error object will be returned.

Object example

{
"payment": "prepaid",
"type": "euros",
"amount": 103
}
cURL
PHP
Node
C#
Java
Ruby
Go
Python
Cookie Settings