Skip to main content

Make a Withdrawal​

In order to withdraw your funds, you need to send a GET request to the following endpoint:

GET https://www.mimbla.com/api/v1/merchant/withdrawal/{id}

The request should include the withdrawal ID in the URL path. This endpoint allows you to check the status of a specific withdrawal request.

Example Request​

GET https://www.mimbla.com/api/v1/merchant/withdrawal/299
Content-Type: application/json

{
    "status": "completed",
    "tx_id": "7c21b973a5d7d449db9ae729621a2f6cc476f0c3136079f45e02e8cee386cded"
}

Note: the tx_id field will only be present if the withdrawal has been completed successfully. It contains the transaction ID of the withdrawal in the blockchain. However, if the withdrawal is still pending or has failed, this field will not be present in the response. The TX ID may not always be available in the response, sometimes it may return a null value or be omitted entirely, depending on the status of the withdrawal.

Example Successful Response​

If your request is successful, you will receive a response with the http status code 201 and the following body:

{
    "status": "completed",
    "tx_id": "7c21b973a5d7d449db9ae729621a2f6cc476f0c3136079f45e02e8cee386cded"
}

These transations will be available in your transaction history, which you can access through the Mimbla dashboard.

Example Error Response​

If your request is unsuccessful, you will receive a response with one of the following codes

  • 400 Bad Request
  • 404 Not Found
  • 401 Unauthorized
{
  "status": "error",
  "message": "<error message>"
}