Get Single Balance

Balance for one currency.

Method	GET
URL	/api/m1/balance?currency=NGN
Auth	Bearer ZMPRO-… (live) or ZMDEV-… (test)

Query parameters

Name	Required	Example	Description
currency	Yes	NGN	ISO currency code (e.g. NGN, USD).

Headers

Header	Value
Authorization	Bearer ZMPRO-your-live-api-key

Request

cURL

curl -X GET 'https://api.vizo.app/api/m1/balance?currency=NGN' \
  -H 'Authorization: Bearer ZMPRO-your-live-api-key'

TypeScript

const response = await fetch('https://api.vizo.app/api/m1/balance?currency=NGN', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer ZMPRO-your-live-api-key',
  },
});

const data = await response.json();
console.log(data);

Python

import requests

url = "https://api.vizo.app/api/m1/balance?currency=NGN"
headers = {
    "Authorization": "Bearer ZMPRO-your-live-api-key",
}

response = requests.request("GET", url, headers=headers)
print(response.status_code)
print(response.json())

PHP

<?php

$ch = curl_init('https://api.vizo.app/api/m1/balance?currency=NGN');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ZMPRO-your-live-api-key',
    ],
]);

$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo $status, PHP_EOL, $response, PHP_EOL;

Responses

Get Single Balance — 200 OK

{
  "status": true,
  "data": {
    "2": {
      "id": "VDyAEVMBR7SMD4dA1DMkh7VNjxLKZzUX423EN6DjcQnLvPVnMxi6XROERD5Y",
      "currency": "NGN",
      "available_balance": 20054.9,
      "ledger_balance": 0,
      "input_at": "2022-08-30T19:58:18.000000Z",
      "update_at": "2022-08-31T16:07:43.000000Z"
    }
  },
  "message": "Success"
}