Retrieve account balance

Archived

This command will return the number of credits available on your account.

If you simply want to monitor your account balance, you can receive SMS and email notifications when your account balance reaches a certain amount. This can be configured within your Developers Central account.

Command

https://api.clickatell.com/http/getbalance?user=xxxx&password=xxxx&api_id=xxxx

Parameters

You need to supply the authentication parameters that are outlined here.

Examples

Bash

username="place username here"
password="place password here"
api_id="place password here"
curl --data "user=$username&password=$password&api_id=$api_id" \
    'https://api.clickatell.com/http/getbalance'

PHP

<?php
$username = urlencode("place username here");
$password = urlencode("place password here");
$api_id   = urlencode("place api_id here");
 
echo file_get_contents("https://api.clickatell.com/http/getbalance"
   . "?user=$username&password=$password&api_id=$api_id");
?>

Python

import urllib2, urllib
 
params = {
    "user": "place username here",
    "password": "place password here",
    "api_id": "place password here"
}
 
params = urllib.urlencode(params)
f = urllib2.urlopen("https://api.clickatell.com/http/getbalance", params)
print f.read()

API responses

Example response

Successful API response:

Credits: 123.00 

Error response:

ERR: 001, Authentication failed

Format

Successful API response:

Credits: <balance>

Error response:

ERR: <error code>, <error description>