curl --request GET \
  --url https://api.nomba.com/v1/transactions/accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'accountId: <accountid>'
{
  "code": "00",
  "description": "Success",
  "data": {
    "results": [
      {
        "id": "POS-WITHDRAW-DFC05-693cd007-cd1e-4ea6-8b79-5f5c4d7a83ea",
        "status": "PAYMENT_FAILED",
        "amount": 4000,
        "fixedCharge": 123,
        "source": "pos",
        "type": "withdrawal",
        "gatewayMessage": "Insufficient funds",
        "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 transactions on the parent account

Filter parent account transactions

​
GET /v1/transactions/accounts

​
Query parameters

​
limit
integer

This endpoint is paginated. limit describes the size of the page you are querying.

​
cursor
string

The cursor is used to scroll to the next page. When making the first call to list all accounts, there is no need to pass in any cursor since the API has not returned any cursor back to you. Only use cursor when the API provides it. For more information, please see Pagination

​
dateFrom
string

This starting date. Expected format: yyyy-MM-dd'T'HH:mm:ss (in UTC)

​
dateTo
string

This ending date. Expected format: yyyy-MM-dd'T'HH:mm:ss (in UTC)

​
Response body

​
code
string
required

Response code

​
description
string
required

Response description

​
data
object
required
curl --request GET \
  --url https://api.nomba.com/v1/transactions/accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'accountId: <accountid>'
{
  "code": "00",
  "description": "Success",
  "data": {
    "results": [
      {
        "id": "POS-WITHDRAW-DFC05-693cd007-cd1e-4ea6-8b79-5f5c4d7a83ea",
        "status": "PAYMENT_FAILED",
        "amount": 4000,
        "fixedCharge": 123,
        "source": "pos",
        "type": "withdrawal",
        "gatewayMessage": "Insufficient funds",
        "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"
  }
}