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 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 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.
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 <token>' \
  --header 'accountId: <accountId>'

Fetch Bank Transactions

To fetch debit or credit transactions associated with an account, make a GET Request to /v1/transactions/bank.
  curl --request GET \
    --url https://api.nomba.com/v1/transactions/bank \
    --header 'Authorization: Bearer <token>' \
    --header 'accountId: <accountId>'

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.
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>'

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.
curl --request GET \
  --url https://api.nomba.com/v1/transactions/requery/<sessionId> \
  --header 'Authorization: Bearer <token>' \
  --header 'accountId: <accountId>'