> ## Documentation Index
> Fetch the complete documentation index at: https://developer.nomba.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Fetch Transactions
> Learn how to fetch transactions associated with an account.
## Overview
You may need to check the status of a transaction or retrieve a list of transactions for reconciliation purposes.
Nomba provides multiple APIs for fetching different types of transactions—for example, debit/credit, virtual account, or parent account transactions. Depending on your use case, you can explore the relevant fetch transaction endpoint.
Transaction APIs are paginated. We recommend reviewing the [pagination guide](/docs/api-basics/pagination) to understand how to work with paginated endpoints or trying out live API interactions to see how it works in practice.
## Fetch Account Transactions
To fetch account transactions within a specific timeframe, make a [GET request](/nomba-api-reference/transactions/fetch-transactions-on-the-parent-account) to `/v1/transactions/accounts` or see the sample request and response below:You can pass a query param to specify a timeframe by passing `dateFrom` and `dateTo` as part of the request. You can also set a limit, as it's a paginated endpoint.
To learn how Nomba handles pagination, [check here.](/docs/api-basics/pagination)
```bash Request theme={null}
curl --request GET \
--url https://api.nomba.com/v1/transactions/accounts?limit=10&dateFrom=2023-01-01T00%3A00%3A00&dateTo=2025-01-01T00%3A00%3A00' \
--header 'Authorization: Bearer ' \
--header 'accountId: '
```
```json expandable Response theme={null}
{
"code": "00",
"description": "Success",
"data": {
"results": [
{
"id": "POS-WITHDRAW-DFC05-693cd007-cd1e-4ea6-8b79-5f5c4d7a83ea",
"status": "SUCCESS",
"amount": 4000,
"fixedCharge": 123,
"source": "pos",
"type": "withdrawal",
"gatewayMessage": "SUCCESS",
"customerBillerId": "539983 **** **** 5118",
"timeCreated": "2023-09-08T19:26:34.657000Z",
"posTid": "2KUD4AKB",
"terminalId": "2KUD4AKB",
"providerTerminalId": "2KUD4AKB",
"rrn": "230908202632",
"posSerialNumber": "91230309116826",
"posTerminalLabel": "KEB MUSA ABUBAKAR",
"stan": "556734",
"paymentVendorReference": "2KUD4AKB230908202632",
"userId": "dfc05ca1-4e75-41dd-8e41-2d362d565893",
"posRrn": "230908202632",
"merchantTxRef": "c90d-4b25-ad0f"
}
],
"cursor": "xchbaVFsjdsbaADddd"
}
}
```
## Fetch Bank Transactions
To fetch debit or credit transactions associated with an account, make a [GET Request](/nomba-api-reference/transactions/fetch-creditdebit-transactions-on-the-parent-account) to `/v1/transactions/bank`.
```bash Request theme={null}
curl --request GET \
--url https://api.nomba.com/v1/transactions/bank \
--header 'Authorization: Bearer ' \
--header 'accountId: '
```
```json expandable Response theme={null}
{
"code": "00",
"description": "Success",
"data": {
"results": [
{
"amount": 7000,
"currency": "NGN",
"meta": {
"billerId": "API_FCIR5UQFMYS",
"terminalActionId": "",
"productId": "p2p",
"fee": 0,
"type": "p2p",
"transactionId": "API-P2P-84026-d8a4d658-6747-418d-a7e2-37bc6290310d",
"rrn": "",
"parentAccountId": "01a10aeb-d989-460a-bbde-9842f2b4320f",
"terminalLabel": "",
"accountId": "890022ce-bae0-45c1-9b9d-ee7872e6ca27",
"merchantTxRef": "",
"transactionAmount": 7000,
"mCollectionsId": ""
},
"status": "SUCCESS",
"timeUpdated": "2023-09-08T19:05:21.000Z",
"walletBalance": 285951,
"transactionType": "DEBIT"
}
],
"cursor": "xchbaVFsjdsbaADddd"
}
}
```
## Fetch Virtual Account Transactions
To fetch transactions on a virtual account, make a GET request to `/v1/transactions/virtual`.
Pass the virtual\_account query parameter with the account number. You can also filter by `dateFrom` and `dateTo`.
```bash Request theme={null}
curl --request GET \
--url'https://api.nomba.com/v1/transactions/virtual?virtual_account=8578228675&dateFrom=2025-06-24&dateTo=2025-06-25' \
--header 'accountId: ' \
--header 'Authorization: Bearer '
```
```json expandable Response theme={null}
{
"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
Use this endpoint to confirm the status of a transaction using its `sessionId`.
To obtain a session ID, first filter through virtual account transactions to locate the transaction you want to requery.
```bash Request theme={null}
curl --request GET \
--url https://api.nomba.com/v1/transactions/requery/ \
--header 'Authorization: Bearer ' \
--header 'accountId: '
```
```json expandable Response theme={null}
{
"code": "00",
"description": "Requery Successful",
"data": {
"id": "API-VACT_TRA-185C7-01964b64-5c0a-4c91-81b6-zxv7a421862b",
"status": "SUCCESS",
"amount": "200.0",
"fixedCharge": "1.0",
"source": "api",
"type": "vact_transfer",
"customerBillerId": "0122408496",
"timeCreated": "2024-07-11T16:12:49.656Z",
"walletBalance": "1648.79",
"billingVendorReference": "029004810da38748e93ca4a9",
"paymentVendorReference": "000132891359184717316165338085",
"userId": "185c75d9-6ae0-675r-950e-425666184ed6",
"ktaSenderName": "Smart Hamzat",
"ktaSenderAccountNumber": "0122408496",
"ktaSenderBankCode": "Amucha MFB (Nomba)",
"recipientAccountNumber": "0014701211",
"recipientAccountType": "VIRTUAL",
"senderName": "Smart Hamzat",
"bankCode": "090645",
"productId": "090645",
"isAgentTransaction": true,
"isInternational": false,
"customerCommission": 0,
"recipientAccountName": "John Amazing Doe",
"sessionId": "000132891359184717316165338085",
"accountNumber": "0122408496",
"bankName": "Amucha (Nomba)"
}
}
```