List Transactions (and fetch by reference)

GET

/api/v1/transactions

Unified paged feed of collections across TRANSFER, CARD and USSD, newest first. All filters optional. To fetch a single transaction for reconciliation, pass search={transactionRef}.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Query Params

Responses

🟢200

application/json

Paged transactions.

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://merchantapi-dev.vantpay.io/api/v1/transactions?customerId=&channel=&status=&search=&startDate=&endDate=&pageNumber=&pageSize=' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "isSuccessful": true,
    "code": "00",
    "message": "Operation successful",
    "data": {
        "currentPage": 1,
        "pageSize": 20,
        "totalRecords": 1,
        "totalPages": 1,
        "data": [
            {
                "reference": "de95884fbfaa8285e29964df2c1b2be8",
                "clientReference": "ORD-260909-0012",
                "channel": "TRANSFER",
                "amount": 20000,
                "fee": 100,
                "net": 19900,
                "currency": "NGN",
                "status": "SUCCESSFUL",
                "narration": "Virtual Account Credit",
                "provider": "DIGITVANT",
                "paidAt": "2026-09-08T16:04:14",
                "customerId": "CUS1a2b3c4",
                "customerName": "Ifeanyi Chimezie",
                "customerEmail": "chimezie@example.com",
                "customerPhone": "09036261535",
                "payerName": "Innocent Orji",
                "sourceAccount": "1000203425",
                "sourceBank": "Digitvant MFB"
            }
        ]
    }
}

Modified at 2026-09-10 13:32:03

query-access-code

Get Wallet Balance