This API allows you to get a list of all disbursement transactions.
Endpoint
GET: https://sandbox.monnify.com/api/v2/disbursements/search-transactions?sourceAccountNumber={sourceAccountNumber}&pageNo={pageNo}&pageSize={pageSize}
This endpoint is protected with Basic Authentication
The following query parameters are supported:
Field Reference:
Field | Description | Status |
---|---|---|
pageNumber | A number specifying what page of transfers to be retrieved. Minimum value is 0, and defaults to 0 if not specified. | Optional |
pageSize | A number specifying size of each transfer page. Minimum value is 1, and defaults to 10 if not specified. | Optional |
sourceAccountNumber | Unique identifier of your wallet. Can be obtained on the disbursements page on the web portal and is represented as WALLET ACCOUNT NUMBER. | Mandatory |
transactionReference | The unique reference for a disbursement transaction. | Optional |
startDate | A timestamp value specifying the date to start filtering disbursement transactions by the createdAt field | Optional |
endDate | A timestamp value specifying the date to stop filtering disbursement transactions by the createdAt field | Optional |
amountFrom | A number specifying the lower bound for filtering the transactions by the amount field | Optional |
amountTo | A number specifying the upper bound for filtering the transactions by the amount field | Optional |
Below is a sample response for getting all disbursement transactions:
{ "requestSuccessful": true, "responseMessage": "success", "responseCode": "0", "responseBody": { "content": [ { "amount": 50.00, "reference": "ref1622802875358", "narration": "You deserve to be pampered", "currency": "NGN", "fee": 35.00, "twoFaEnabled": false, "status": "FAILED", "transactionDescription": "Failed", "transactionReference": "MFDS20210604113438AAABLD", "createdOn": "2021-06-04T10:34:38.000+0000", "sourceAccountNumber": "3262925591", "destinationAccountNumber": "0035785417", "destinationAccountName": "AMADI SOLOMON E", "destinationBankCode": "044", "destinationBankName": "Access bank" }, { "amount": 50.00, "reference": "ref1622626340871", "narration": "You deserve to be pampered", "currency": "NGN", "fee": 35.00, "twoFaEnabled": false, "status": "FAILED", "transactionDescription": "An error occurred during NE", "transactionReference": "MFDS20210602103222AAABHU", "createdOn": "2021-06-02T09:32:23.000+0000", "sourceAccountNumber": "3262925591", "destinationAccountNumber": "0035785417", "destinationBankCode": "044", "destinationBankName": "Access bank" }, { "amount": 50.00, "reference": "ref1622626308270", "narration": "You deserve to be pampered", "currency": "NGN", "fee": 35.00, "twoFaEnabled": true, "status": "EXPIRED", "transactionDescription": "Transaction has expired", "transactionReference": "MFDS20210602103150AAABHT", "createdOn": "2021-06-02T09:31:50.000+0000", "sourceAccountNumber": "3262925591", "destinationAccountNumber": "0035785417", "destinationAccountName": "AMADI SOLOMON E", "destinationBankCode": "044", "destinationBankName": "Access bank" } ], "pageable": { "sort": { "sorted": true, "unsorted": false, "empty": false }, "pageSize": 10, "pageNumber": 0, "offset": 0, "unpaged": false, "paged": true }, "totalElements": 3, "totalPages": 1, "last": true, "sort": { "sorted": true, "unsorted": false, "empty": false }, "first": true, "numberOfElements": 3, "size": 10, "number": 0, "empty": false } }