This will show the number of credits available on your account.
GET https://api.clickatell.com/rest/account/balance
Note that the REST API may respond with various HTTP status codes. See the full list here.
JSON
Request
GET /rest/account/balance HTTP/1.1
HOST: api.clickatell.com
X-Version: 1
Authorization: Bearer [Your Authorization Token]
Accept: application/json
Response
HTTP/1.1 200 OK
Content-Type: application/json
{
"data":{
"balance":"300.50"
}
}XML
Request
GET /rest/account/balance HTTP/1.1
HOST: api.clickatell.com
X-Version: 1
Authorization: Bearer [Your Authorization Token]
Accept: application/xml
Response
HTTP/1.1 200 OK Content-Type: application/xml <?xml version="1.0"?> <response> <data> <balance>300.50</balance> </data> </response>
Sample code
cURL
authToken=""
curl -X GET \
-H "X-Version: 1" \
-H "Accept: application/json" \
-H "Authorization: Bearer $authToken" \
https://api.clickatell.com/rest/account/balance
Python
import httplib2, json authToken = "place auth token here" resp, content = httplib2.Http().request( "https://api.clickatell.com/rest/account/balance", "GET", headers={ "X-Version" : "1", "Accept" : "application/json", "Authorization" : "Bearer " + authToken } )
PHP
<?php $authToken = "<place auth token here>"; $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, "https://api.clickatell.com/rest/account/balance"); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); curl_setopt($ch, CURLOPT_HTTPHEADER, array( "X-Version: 1", "Accept: application/json", "Authorization: Bearer $authToken" )); $result = curl_exec ($ch); ?>