The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.


SMS::MessageBird::API::Balance - Sub-module for the SMS::MessageBird distribution.


This is a sub-module which is part of the SMS::MessageBird distribution.

While this module can be used directly, it's designed to be used via SMS::MessageBird


This module provides the interface to the Balance method of the MessageBird JSON API.

The methods implmented acceept the paramteres as named in the MessageBird API documentation which can be found at the MessageBird Developer Documentation. If you're using this distribution you should be familiar with the API documentation.

Response Data

Every method returns a standardised hashref containin the following keys:


Value of 0 or 1. Indicates if the request was completed successfully or not. This value is based on LWP::UserAgent's is_success() method.


This is the HTTP code returned by the API. In the event of ok => 0 - it's possible that the request was a 401 etc. So this is provided for sanity checking.


This is a Perl hashref data structure decoded from the API's response JSON as-is.

Please see the MessageBird Developer Documentation for more information on the expected structure.



  Out: $response - Hashref of response data. See "Response Data" above.

This method implements the GET /balance route of the API.

Requests the balance information for the authenticated MessageBird account. The authenticated account is the one tied to the api_key supplied to this or the SMS::MessageBird module upon instantiation.

Please see the MessageBird API Documentation for more information.


James Ronan, <james at>


Please report any bugs or feature requests to bug-sms-messagebird at, or through the web interface at I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

Alternatively you can raise an issue on the source code which is available on GitHub.


Copyright 2016 James Ronan.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.