Search Disbursement Transactions

This API allows you to get a list of all your disbursement transactions done on Monnify.

This endpoint is protected with OAuth 2.0 Bearer token. To find out more about authorization for Monnify endpoints, check Here.

Endpoint URL: {{base_url}}/api/v2/disbursements/search-transactions?sourceAccountNumber={sourceAccountNumber}&pageNo={pageNo}&pageSize={pageSize}

HTTP Method: GET

The {{base_url}} for test is https://sandbox.monnify.com but when you go live, it changes to the live url

The following query parameters are supported:

Field Reference

Field

Optional/Mandatory

Description

Field

Optional/Mandatory

Description

pageNumber

Optional

A number specifying what page of transfers to be retrieved. Minimum value is 0, and defaults to 0 if not specified.

pageSize

Optional

A number specifying size of each transfer page. Minimum value is 1, and defaults to 10 if not specified.

sourceAccountNumber

Mandatory

Unique identifier of your wallet. Can be obtained on the disbursements page on the web portal and is represented as WALLET ACCOUNT NUMBER.

transactionReference

Optional

The unique reference for a disbursement transaction.

startDate

Optional

A timestamp value specifying the date to start filtering disbursement transactions by the createdAt field

endDate

Optional

A timestamp value specifying the date to stop filtering disbursement transactions by the createdAt field

amountFrom

Optional

A number specifying the lower bound for filtering the transactions by the amount field

amountTo

Optional

A number specifying the upper bound for filtering the transactions by the amount field.

Below is a sample response for getting all disbursement transactions:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 { "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 } }