Requeue All Failed Transfers

Our APIs enable retrying failed disbursements without updating the references in your system.

Call the requeue failed disbursements endpoint and supply the batch reference. This will initiate a retry of all the failed disbursements contained in the batch.

post

Authorizations

Path parameters

batch_referencestringRequired

Responses

200

Success

application/json

post

HTTPcURLJavaScriptPython

POST /v1/transfers/batch/requeue-failed/{batch_reference} HTTP/1.1
Host: 
Authorization: YOUR_API_KEY
Accept: */*

200

Success

{
  "status": "success",
  "message": "text",
  "data": {
    "id": "text",
    "is_live": true,
    "batch_reference": "text",
    "source_currency": "text",
    "break_on_validation_failure": true,
    "two_factor_enabled": true,
    "otp_sent": true,
    "otp_expires_at": "2025-05-20T15:29:47.872Z",
    "otp_validated": true,
    "otp_validated_at": "2025-05-20T15:29:47.872Z",
    "total_count": 1,
    "failed_count": 1,
    "successful_count": 1,
    "total_amount": 1,
    "total_successful_amount": 1,
    "total_fee": 1,
    "batch_webhook_type": "batchOnly",
    "batch_notification_interval": "tenPercent",
    "title": "text",
    "description": "text",
    "status": "allSuccessful",
    "created_at": "2025-05-20T15:29:47.872Z",
    "edited_at": "2025-05-20T15:29:47.872Z"
  },
  "meta": {},
  "errors": {
    "ANY_ADDITIONAL_PROPERTY": [
      "text"
    ]
  },
  "is_error": true
}