curl --request GET \
--url'https://api.nomba.com/v1/transactions/virtual?virtual_account=8578228675&dateFrom=2025-06-24&dateTo=2025-06-25' \
--header 'accountId: <your-account-id>' \
--header 'Authorization: Bearer <your-token>'

{
    "code": "00",
    "description": "SUCCESS",
    "data": {
        "cursor": "",
        "results": [
            {
                "id": "API-VACT_TRA-FFCBE-9eb634eb-4dc5-46a9-bb65-7d03d6b88c1c",
                "status": "SUCCESS",
                "amount": "100.0",
                "fixedCharge": "0.5",
                "source": "api",
                "type": "vact_transfer",
                "customerBillerId": "8065219824",
                "timeCreated": "2025-06-24T11:31:35.017Z",
                "timeUpdated": "2025-06-24T11:31:35.107Z",
                "posTid": "",
                "posSerialNumber": "",
                "walletCurrency": "NGN",
                "walletBalance": "457.0",
                "billingVendorReference": "685a8c973ccb33995cbefc1f",
                "paymentVendorReference": "038309078367093226893790137012",
                "userId": "***",
                "ktaSenderName": "John doe",
                "ktaSenderAccountNumber": "8068952954",
                "ktaSenderBankCode": "Paycom (Opay)",
                "recipientAccountNumber": "8578228675",
                "recipientAccountType": "VIRTUAL",
                "senderName": "John Doe",
                "currency": "NGN",
                "bankCode": "305",
                "productId": "305",
                "isAgentTransaction": true,
                "isInternational": false,
                "customerCommission": "0.00",
                "recipientAccountName": "Clean/Agboola Oyenike",
                "sessionId": "100004250624113131135397696024",
                "accountNumber": "8028952054",
                "bankName": "Paycom (Opay)",
                "entryType": "CREDIT",
                "transactionCategory": "Income",
                "narration": "Transfer from John Doe",
                "receiptTerminalId": ""
            }
        ]
    },
    "status": false
}

`GET /v1/transactions/virtual`

Use this endpoint to fetch a list of transactions made to a virtual account over a specific date range.

Query Parameters

virtual_account

string

required

The virtual account number whose transactions you want to retrieve.

dateFrom

string

required

Start date for transaction search (in ISO 8601 format).

dateTo

string

required

End date for transaction search (in ISO 8601 format).

Request Headers

accountId

string

required

Your parent account ID.

Authorization

string

required

Bearer token for authentication.

Response Body

code

string

required

Response code

description

string

required

Response description

data

object

Hide object

cursor

string

Pagination cursor (if available).

results

array

Hide Transaction Object

string

required

Unique transaction ID.

status

string

required

Transaction status (e.g., SUCCESS, FAILED).

amount

string

required

Transaction amount.

fixedCharge

string

Flat fee charged for the transaction.

source

string

Source of the transaction (e.g., api).

type

string

Transaction type (e.g., vact_transfer).

customerBillerId

string

Customer biller identifier.

timeCreated

string

ISO timestamp when the transaction was created.

timeUpdated

string

ISO timestamp when the transaction was last updated.

posTid

string

POS terminal ID, if applicable.

posSerialNumber

string

Serial number of the POS used (if any).

walletCurrency

string

Currency of the wallet (e.g., NGN).

walletBalance

string

Wallet balance after the transaction.

billingVendorReference

string

Reference from billing vendor.

paymentVendorReference

string

Reference from payment vendor.

userId

string

ID of the user that initiated the transaction.

ktaSenderName

string

Full name of the sender (from KTA).

ktaSenderAccountNumber

string

Sender’s account number (from KTA).

ktaSenderBankCode

string

Sender’s bank name or code (from KTA).

recipientAccountNumber

string

Virtual account number receiving the funds.

recipientAccountType

string

Type of recipient account (e.g., VIRTUAL).

recipientAccountName

string

Name on the recipient virtual account.

senderName

string

Display name of the sender.

currency

string

Transaction currency (e.g., NGN).

bankCode

string

Code of the bank involved.

bankName

string

Bank name used in the transaction.

productId

string

Product identifier.

isAgentTransaction

boolean

Whether the transaction was initiated by an agent.

isInternational

boolean

Whether the transaction was international.

customerCommission

string

Commission earned by customer, if any.

sessionId

string

Unique session ID for the transaction.

accountNumber

string

Sender’s account number.

entryType

string

CREDIT or DEBIT.

transactionCategory

string

Transaction category (e.g., Income).

narration

string

Description or note attached to the transaction.

receiptTerminalId

string

Receipt terminal ID, if applicable.

curl --request GET \
--url'https://api.nomba.com/v1/transactions/virtual?virtual_account=8578228675&dateFrom=2025-06-24&dateTo=2025-06-25' \
--header 'accountId: <your-account-id>' \
--header 'Authorization: Bearer <your-token>'

{
    "code": "00",
    "description": "SUCCESS",
    "data": {
        "cursor": "",
        "results": [
            {
                "id": "API-VACT_TRA-FFCBE-9eb634eb-4dc5-46a9-bb65-7d03d6b88c1c",
                "status": "SUCCESS",
                "amount": "100.0",
                "fixedCharge": "0.5",
                "source": "api",
                "type": "vact_transfer",
                "customerBillerId": "8065219824",
                "timeCreated": "2025-06-24T11:31:35.017Z",
                "timeUpdated": "2025-06-24T11:31:35.107Z",
                "posTid": "",
                "posSerialNumber": "",
                "walletCurrency": "NGN",
                "walletBalance": "457.0",
                "billingVendorReference": "685a8c973ccb33995cbefc1f",
                "paymentVendorReference": "038309078367093226893790137012",
                "userId": "***",
                "ktaSenderName": "John doe",
                "ktaSenderAccountNumber": "8068952954",
                "ktaSenderBankCode": "Paycom (Opay)",
                "recipientAccountNumber": "8578228675",
                "recipientAccountType": "VIRTUAL",
                "senderName": "John Doe",
                "currency": "NGN",
                "bankCode": "305",
                "productId": "305",
                "isAgentTransaction": true,
                "isInternational": false,
                "customerCommission": "0.00",
                "recipientAccountName": "Clean/Agboola Oyenike",
                "sessionId": "100004250624113131135397696024",
                "accountNumber": "8028952054",
                "bankName": "Paycom (Opay)",
                "entryType": "CREDIT",
                "transactionCategory": "Income",
                "narration": "Transfer from John Doe",
                "receiptTerminalId": ""
            }
        ]
    },
    "status": false
}

Transaction Requery Fetch Data Plans

curl --request GET \
--url'https://api.nomba.com/v1/transactions/virtual?virtual_account=8578228675&dateFrom=2025-06-24&dateTo=2025-06-25' \
--header 'accountId: <your-account-id>' \
--header 'Authorization: Bearer <your-token>'

{
    "code": "00",
    "description": "SUCCESS",
    "data": {
        "cursor": "",
        "results": [
            {
                "id": "API-VACT_TRA-FFCBE-9eb634eb-4dc5-46a9-bb65-7d03d6b88c1c",
                "status": "SUCCESS",
                "amount": "100.0",
                "fixedCharge": "0.5",
                "source": "api",
                "type": "vact_transfer",
                "customerBillerId": "8065219824",
                "timeCreated": "2025-06-24T11:31:35.017Z",
                "timeUpdated": "2025-06-24T11:31:35.107Z",
                "posTid": "",
                "posSerialNumber": "",
                "walletCurrency": "NGN",
                "walletBalance": "457.0",
                "billingVendorReference": "685a8c973ccb33995cbefc1f",
                "paymentVendorReference": "038309078367093226893790137012",
                "userId": "***",
                "ktaSenderName": "John doe",
                "ktaSenderAccountNumber": "8068952954",
                "ktaSenderBankCode": "Paycom (Opay)",
                "recipientAccountNumber": "8578228675",
                "recipientAccountType": "VIRTUAL",
                "senderName": "John Doe",
                "currency": "NGN",
                "bankCode": "305",
                "productId": "305",
                "isAgentTransaction": true,
                "isInternational": false,
                "customerCommission": "0.00",
                "recipientAccountName": "Clean/Agboola Oyenike",
                "sessionId": "100004250624113131135397696024",
                "accountNumber": "8028952054",
                "bankName": "Paycom (Opay)",
                "entryType": "CREDIT",
                "transactionCategory": "Income",
                "narration": "Transfer from John Doe",
                "receiptTerminalId": ""
            }
        ]
    },
    "status": false
}

Introduction

Getting Started

Plugins and SDKs

Products

Guides

API Patterns

Support

Fetch Virtual Account Transactions

`GET /v1/transactions/virtual`

Query Parameters

Request Headers

Response Body

Introduction

Getting Started

Plugins and SDKs

Products

Guides

API Patterns

Support

​GET /v1/transactions/virtual

​Query Parameters

​Request Headers

​Response Body

`GET /v1/transactions/virtual`

Query Parameters

Request Headers

Response Body