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

{
  "code": "00",
  "description": "SUCCESS",
  "status": true,
  "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",
        "walletCurrency": "NGN",
        "walletBalance": "457.0",
        "senderName": "John Doe",
        "recipientAccountNumber": "8578228675",
        "recipientAccountType": "VIRTUAL",
        "recipientAccountName": "Clean/Agboola Oyenike",
        "sessionId": "100004250624113131135397696024",
        "bankName": "Paycom (Opay)",
        "entryType": "CREDIT",
        "transactionCategory": "Income",
        "narration": "Transfer from John Doe"
      }
    ]
  }
}

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

{
  "code": "00",
  "description": "SUCCESS",
  "status": true,
  "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",
        "walletCurrency": "NGN",
        "walletBalance": "457.0",
        "senderName": "John Doe",
        "recipientAccountNumber": "8578228675",
        "recipientAccountType": "VIRTUAL",
        "recipientAccountName": "Clean/Agboola Oyenike",
        "sessionId": "100004250624113131135397696024",
        "bankName": "Paycom (Opay)",
        "entryType": "CREDIT",
        "transactionCategory": "Income",
        "narration": "Transfer from John Doe"
      }
    ]
  }
}

Fetch virtual account transactions

`GET /v1/transactions/virtual`

Fetch transactions on a virtual account. Pass the virtual_account query parameter with the account number. You can also filter by dateFrom and dateTo.

Transaction APIs are paginated. We recommend reviewing the pagination guide to understand how to work with paginated endpoints.

Query parameters

string

required

The virtual account number

string

Start date for filtering transactions

string

End date for filtering transactions

Response body

string

required

Response code

string

required

Response description

object

Hide object

object[]

List of virtual account transactions

string

Pagination cursor for next page

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

{
  "code": "00",
  "description": "SUCCESS",
  "status": true,
  "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",
        "walletCurrency": "NGN",
        "walletBalance": "457.0",
        "senderName": "John Doe",
        "recipientAccountNumber": "8578228675",
        "recipientAccountType": "VIRTUAL",
        "recipientAccountName": "Clean/Agboola Oyenike",
        "sessionId": "100004250624113131135397696024",
        "bankName": "Paycom (Opay)",
        "entryType": "CREDIT",
        "transactionCategory": "Income",
        "narration": "Transfer from John Doe"
      }
    ]
  }
}

Introduction

Getting Started

Products

API Basics

Guides

Fetch Virtual Account Transactions

Fetch virtual account transactions

`GET /v1/transactions/virtual`

Query parameters

Response body

Fetch virtual account transactions

​GET /v1/transactions/virtual

​Query parameters

​Response body

`GET /v1/transactions/virtual`

Query parameters

Response body