curl --request GET \
  --url 'https://api.nomba.com/v1/transactions/accounts?limit=10&dateFrom=2023-01-01T00:00:00&dateTo=2025-01-01T00:00:00' \
  --header 'Authorization: Bearer <token>' \
  --header 'accountId: <accountId>'

{
  "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",
        "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"
  }
}

curl --request GET \
  --url 'https://api.nomba.com/v1/transactions/accounts?limit=10&dateFrom=2023-01-01T00:00:00&dateTo=2025-01-01T00:00:00' \
  --header 'Authorization: Bearer <token>' \
  --header 'accountId: <accountId>'

{
  "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",
        "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 transactions on the parent account

`GET /v1/transactions/accounts`

Fetch account transactions within a specific timeframe. You can pass query params to specify a timeframe using dateFrom and dateTo. You can also set a limit as it’s a paginated endpoint.

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

Query parameters

integer

Number of results to return per page

string

Start date for filtering transactions (ISO 8601 format)

string

End date for filtering transactions (ISO 8601 format)

Response body

string

required

Response code

string

required

Response description

object

Hide object

object[]

List of transactions

string

Pagination cursor for next page

curl --request GET \
  --url 'https://api.nomba.com/v1/transactions/accounts?limit=10&dateFrom=2023-01-01T00:00:00&dateTo=2025-01-01T00:00:00' \
  --header 'Authorization: Bearer <token>' \
  --header 'accountId: <accountId>'

{
  "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",
        "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"
  }
}

Introduction

Getting Started

Products

API Basics

Guides

Fetch Account Transactions

Fetch transactions on the parent account

`GET /v1/transactions/accounts`

Query parameters

Response body

Fetch transactions on the parent account

​GET /v1/transactions/accounts

​Query parameters

​Response body

`GET /v1/transactions/accounts`

Query parameters

Response body