List withdrawals

GET/api/merchant/withdrawals

List withdrawals

Request

Parameters

Name	Location	Type	Required
status	query	string	No
limit	query	integer	No

Responses

200 Withdrawals

Example response

{
  "message": "withdrawals fetched",
  "response": [
    {
      "withdrawalId": "mwd_123e4567-e89b-12d3-a456-426614174000",
      "amount": 25000,
      "currency": "NGN",
      "status": "pending_otp",
      "destinationAccountNumber": "0123456789",
      "destinationBankCode": "100033",
      "destinationBankName": "PALMPAY",
      "destinationAccountName": "Jane Doe",
      "onchainTxHash": "",
      "providerTransferRef": "",
      "sessionId": "",
      "failureReason": "",
      "otpIssuedAt": "2026-08-24T12:00:00.000Z",
      "createdAt": "2026-08-24T12:00:00.000Z",
      "updatedAt": "2026-08-24T12:00:00.000Z"
    }
  ]
}