Get Transaction History

Paginated merchant charge transactions.

Method	GET
URL	/api/m1/transaction-history?page=1&number_of_item=20
Auth	Bearer ZMPRO-… (live) or ZMDEV-… (test)

Body parameters

Field	Required	Example	Description
account_number	Yes	0690000032	Destination account number.
bank_code	Yes	044	Destination bank code.

Query parameters

Name	Required	Example	Description
page	—	1	Page number (1-based).
number_of_item	—	20	Page size.

Headers

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

Request

cURL

curl -X GET 'https://api.vizo.app/api/m1/transaction-history?page=1&number_of_item=20' \
  -H 'Authorization: Bearer ZMPRO-your-live-api-key'

TypeScript

const response = await fetch('https://api.vizo.app/api/m1/transaction-history?page=1&number_of_item=20', {
  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/transaction-history?page=1&number_of_item=20"
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/transaction-history?page=1&number_of_item=20');
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 Transaction — 200 OK

{
  "status": "SUCCESS",
  "data": {
    "current_page": 1,
    "data": [
      {
        "transaction_id": 10096,
        "reference": "tewrdvwee",
        "amount": 100,
        "fee": "0.",
        "currency": "NGN",
        "country": "NG",
        "transaction_status": "INITIATE",
        "transaction_date": "2022-09-02T17:52:50.000000Z"
      },
      {
        "transaction_id": 10095,
        "reference": "Fae3dae344",
        "amount": 100,
        "fee": "0.",
        "currency": "NGN",
        "country": "NG",
        "transaction_status": "INITIATE",
        "transaction_date": "2022-09-02T14:26:05.000000Z"
      },
      {
        "transaction_id": 10094,
        "reference": "Fae3dae34",
        "amount": 100,
        "fee": "0.",
        "currency": "NGN",
        "country": "NG",
        "transaction_status": "INITIATE",
        "transaction_date": "2022-09-02T14:23:13.000000Z"
      },
      {
        "transaction_id": 10093,
        "reference": "2323234344",
        "amount": 100,
        "fee": "0.",
        "currency": "NGN",
        "country": "NG",
        "transaction_status": "INITIATE",
        "transaction_date": "2022-09-02T14:22:10.000000Z"
      },
      {
        "transaction_id": 10092,
        "reference": "23882d2323",
        "amount": 100,
        "fee": "0.",
        "currency": "NGN",
        "country": "NG",
        "transaction_status": "INITIATE",
        "transaction_date": "2022-09-02T14:18:59.000000Z"
      },
      {
        "transaction_id": 10091,
        "reference": "7ESoWOXBtQc",
        "amount": 100,
        "fee": "0.",
        "currency": "NGN",
        "country": "NG",
        "transaction_status": "INITIATE",
        "transaction_date": "2022-09-02T14:00:20.000000Z"
      },
      {
        "transaction_id": 10090,
        "reference": "URew7iTq7mt",
        "amount": 100,
        "fee": "0.",
        "currency": "NGN",
        "country": "NG",
        "transaction_status": "INITIATE",
        "transaction_date": "2022-09-01T05:16:36.000000Z"
      },
      {
        "transaction_id": 10089,
        "reference": "EaGhs0B2Xjw",
        "amount": 100,
        "fee": "0.",
        "currency": "NGN",
        "country": "NG",
        "transaction_status": "INITIATE",
        "transaction_date": "2022-08-31T17:05:34.000000Z"
      },
      {
        "transaction_id": 10086,
        "reference": "aLAWmRinUB3",
        "amount": 100,
        "fee": "0.",
        "currency": "NGN",
        "country": "NG",
        "transaction_status": "INITIATE",
        "transaction_date": "2022-08-31T16:19:37.000000Z"
      },
      {
        "transaction_id": 10087,
        "reference": "tyMz6sVIAEP",
        "amount": 100,
        "fee": "0.",
        "currency": "NGN",
        "country": "NG",
        "transaction_status": "INITIATE",
        "transaction_date": "2022-08-31T16:19:37.000000Z"
      },
      {
        "transaction_id": 10088,
        "reference": "OofZVi1vEkA",
        "amount": 100,
        "fee": "0.",
        "currency": "NGN",
        "country": "NG",
        "transaction_status": "INITIATE",
        "transaction_date": "2022-08-31T16:19:37.000000Z"
      },
      {
        "transaction_id": 10085,
        "reference": "sm0dMQ9VlUb",
        "amount": 100,
        "fee": "0.",
        "currency": "NGN",
        "country": "NG",
        "transaction_status": "INITIATE",
        "transaction_date": "2022-08-31T16:06:50.000000Z"
      },
      {
        "transaction_id": 10080,
        "reference": "L8DB46AsF7V",
        "amount": 100,
        "fee": "0.",
        "currency": "NGN",
        "country": "NG",
        "transaction_status": "COMPLETED",
        "transaction_date": "2022-08-31T14:05:37.000000Z"
      },
      {
        "transaction_id": 10081,
        "reference": "o40e6kNQxjm",
        "amount": 100,
        "fee": "0.",
        "currency": "NGN",
        "country": "NG",
        "transaction_status": "COMPLETED",
        "transaction_date": "2022-08-31T14:05:37.000000Z"
      },
      {
        "transaction_id": 10082,
        "reference": "G6t3XQ4OCHf",
        "amount": 100,
        "fee": "0.",
        "currency": "NGN",
        "country": "NG",
        "transaction_status": "COMPLETED",
        "transaction_date": "2022-08-31T14:05:37.000000Z"
      }
    ],
    "from": 1,
    "last_page": 7,
    "per_page": 15,
    "prev_page_url": null,
    "to": 15,
    "total": 95
  },
  "message": "Success"
}