Get Bank List

Supported banks for a currency corridor.

Method	GET
URL	/api/m1/bank-list?currency_code=ng
Auth	Bearer ZMPRO-… (live) or ZMDEV-… (test)

Query parameters

Name	Required	Example	Description
currency_code	—	ng	Corridor currency code.

Headers

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

Request

cURL

curl -X GET 'https://api.vizo.app/api/m1/bank-list?currency_code=ng' \
  -H 'Authorization: Bearer ZMPRO-your-live-api-key'

TypeScript

const response = await fetch('https://api.vizo.app/api/m1/bank-list?currency_code=ng', {
  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/bank-list?currency_code=ng"
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/bank-list?currency_code=ng');
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 Bank List — 200 OK

{
  "status": "SUCCESS",
  "data": [
    {
      "label": "Mobile Money",
      "value": "mmm",
      "id": "mobilemoney"
    },
    {
      "label": "Page MFBank",
      "value": "560",
      "id": 132
    },
    {
      "label": "Stanbic Mobile Money",
      "value": "304",
      "id": 133
    }
  ],
  "message": "Success"
}
// … truncated, 64 items in full response