Check Account Balance

Caution

For security reasons, please contact your Account Manager to provide you with an API host.

The host https://api.example.com not is a real endpoint.

GET

/v2/balance

• Production

Returns the current balance of your account.

Authorizations

BasicAuth

Use HTTP Basic Authentication to authorize requests.

The password is your API key, not your web portal password.

Example: Authorization: Basic WU9VUl9VU0VSTkFNRV9IRVJFOllPVVJfQVBJX1RPS0VOX0hFUkU=

(Where “YOUR_USERNAME_HERE:YOUR_API_TOKEN_HERE” is Base64-encoded)

Parameters

Query Parameters

accounts

boolean

Set to true to include the balance of all sub-accounts associated with your API key.

Responses

200

Balance account successfully retrieved

object

status

boolean

true

error

boolean

description

Array<object>

object

username

string

DEMO

name

string

DEMO

balance

number format: float

-1

limit_credit

number format: float

0

Example

{
  "status": true,
  "error": false,
  "description": [
    {
      "username": "DEMO",
      "name": "DEMO",
      "balance": -1,
      "limit_credit": 0
    }
  ]
}

400

Missing required parameters

Example

{
  "status": false,
  "error": true,
  "description": "Missing params, please verify or contact to support"
}

401

Your key auth is not valid

Example

{
  "status": false,
  "error": true,
  "description": "Your key auth is not valid, please check with your administrator to get the new key"
}

Examples

Useful for guiding users to view code examples in different developer languages.

Bash

developer@developer:~#

curl -X GET "https://api.example.com/v2/balance?accounts=false" \
    -H "Accept: application/json" \
  -H "Connection: keep-alive" \
  -H "Authorization: Basic <base64-encoded-credentials>"

Node.js

example.js

  const fetch = require('node-fetch');

  fetch("https://api.example.com/v2/balance?accounts=false", {
    method: "GET",
    headers: {
  "Accept": "application/json",
  "Connection": "keep-alive",
  "Authorization": "Basic <base64-encoded-credentials>"
}
  })
    .then(res => res.json())
    .then(console.log)
    .catch(console.error);

PHP

example.php

  <?php
  $curl = curl_init();

  curl_setopt_array($curl, [
    CURLOPT_URL => "https://api.example.com/v2/balance?accounts=false",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
    "Accept: application/json",
    "Connection: keep-alive",
    "Authorization: Basic <base64-encoded-credentials>"
    ]
  ]);

  $response = curl_exec($curl);
  curl_close($curl);
  echo $response;
  ?>

C-Sharp

example.cs

  using System.Net.Http;
  using System.Text;
  using System.Threading.Tasks;

  var client = new HttpClient();
  var request = new HttpRequestMessage(HttpMethod.GET, "https://api.example.com/v2/balance?accounts=false");
  request.Headers.Add("Accept", "application/json");
request.Headers.Add("Connection", "keep-alive");
request.Headers.Add("Authorization", "Basic <base64-encoded-credentials>");
  var response = await client.SendAsync(request);
  var responseBody = await response.Content.ReadAsStringAsync();
  Console.WriteLine(responseBody);

Python

example.py

  import requests
  import json

  url = "https://api.example.com/v2/balance?accounts=false"
  headers = {
    "Accept": "application/json",
  "Connection": "keep-alive",
  "Authorization": "Basic <base64-encoded-credentials>"
  }

  response = requests.get(url, headers=headers)
  print(response.text)

Java

example.java

  import java.io.OutputStream;
  import java.net.HttpURLConnection;
  import java.net.URL;
  import java.nio.charset.StandardCharsets;

  public class ApiExample {
    public static void main(String[] args) throws Exception {
      URL url = new URL("https://api.example.com/v2/balance?accounts=false");
      HttpURLConnection conn = (HttpURLConnection) url.openConnection();
      conn.setRequestMethod("GET");

      conn.setRequestProperty("Accept", "application/json");
    conn.setRequestProperty("Connection", "keep-alive");
    conn.setRequestProperty("Authorization", "Basic <base64-encoded-credentials>");

      int code = conn.getResponseCode();
      System.out.println("Response code: " + code);
    }
  }