Get balance

Check your account balance or a subaccount balance.



api_key Your API Key.
curl -X POST \
 -H 'Content-Type: application/json' \
 -H 'Accept: application/json' \
 -d '{
$request = '{

$headers = array('Content-Type: application/json');            

$ch = curl_init('');

curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER,true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, $request);

$result = curl_exec($ch);

if( !curl_errno($ch) )
    $result = json_decode($result);
    $result = curl_error($ch);
/** Imports */
import org.apache.http.HttpResponse;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.HttpClientBuilder;
/** End imports */

HttpClient httpClient = HttpClientBuilder.create().build();
HttpPost request = new HttpPost("");

StringEntity params = new StringEntity(
"{" +
"    \"api_key\":\"399d2b438a53ebed3db8a7d52107f846\"" +

request.addHeader("content-type", "application/json");
HttpResponse response = httpClient.execute(request);
require 'uri'
require 'net/http'

url = URI("")

http =, url.port)
http.use_ssl = true
http.verify_mode = OpenSSL::SSL::VERIFY_NONE

request =
request["content-type"] = 'application/json'
request["accept"] = 'application/json'

request.body = '{

response = http.request(request)
puts response.read_body
conn = http.client.HTTPSConnection("")

payload = '{

headers = {
    'content-type': "application/json",
    'accept': "application/json"

conn.request("POST", "/api/3.0/account/get-balance", payload, headers)

res = conn.getresponse()
data =

var client = new RestClient("");

var request = new RestRequest(Method.POST);
request.AddHeader("accept", "application/json");
request.AddHeader("content-type", "application/json");
request.AddParameter("application/json", '{
}', ParameterType.RequestBody);

IRestResponse response = client.Execute(request);
Private Sub Command1_Click()
Dim objHTTP As Object
Dim Json As String
Dim result As String

    Json = fJSON
    Set objHTTP = CreateObject("MSXML2.ServerXMLHTTP")
    URl = ""
    objHTTP.Open "POST", URl, False
    objHTTP.setRequestHeader "Content-type", "application/json"
    objHTTP.send (Json)
    result = objHTTP.responseText
   Set objHTTP = Nothing
End Sub

Private Function fJSON() As String
    fJSON = "{"
    fJSON = fJSON & """api_key"":""399d2b438a53ebed3db8a7d52107f846"""
    fJSON = fJSON & "}"
End Function
var data = JSON.stringify({

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === this.DONE) {
});"POST", "");
xhr.setRequestHeader("content-type", "application/json");
xhr.setRequestHeader("accept", "application/json");



status The sending status of request - either "ok", "error"
result Object with the result.
balance The balance amount of your account, not that it's with 4 decimals, Ex: 155.2493
currency Either EUR, USD, GBP, CREDITS, SMS, ...
error_id In case the status values "error" we will indicate you here the error id.
error_msg In case the status values "error" this param has additional information. This param should be use just for debugging.
200 OK
Your account has 350,12 €
200 OK
Your sub-account has 1225 CREDITS
401 Unauthorized
    "error_msg":"Your API key may be invalid or your IP is blocked."
We didn't continue processing your request because your API Key wasn't valid.
400 Bad Request
    "error_msg":"Your JSON was formatted incorrectly."
We couldn't process your request.


Error ID Explanation
INVALID_CONTENT_TYPE The content type must be: Content-Type: application/json
JSON_PARSE_ERROR Your JSON was formatted incorrectly or was considered otherwise improper or incomplete. Check it here.
MISSING_PARAMS Your request is incomplete and missing some mandatory parameters.
UNAUTHORIZED Your API key may be invalid, double-check that your API key was input correctly or see if your current IP is blocked in your account API settings.