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.
Fetch Bank Transactions
To fetch debit or credit transactions associated with an account, make a GET Request to/v1/transactions/bank
.
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
.
Transaction Requery
Use this endpoint to confirm the status of a transaction using itssessionId
.
To obtain a session ID, first filter through virtual account transactions to locate the transaction you want to requery.