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

Bearer

AuthorizationstringRequired

API Key as Bearer Token

Path parameters

batch_referencestringRequired

Responses

200

Success

application/json

statusstring · enumOptionalPossible values:

messagestring · nullableOptional

metaobjectOptional

is_errorbooleanRead-onlyOptional

post

/v1/transfers/batch/requeue-failed/{batch_reference}

HTTPcURLJavaScriptPython

POST /v1/transfers/batch/requeue-failed/{batch_reference} HTTP/1.1
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": "2026-02-20T00:55:29.263Z",
    "otp_validated": true,
    "otp_validated_at": "2026-02-20T00:55:29.263Z",
    "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": "2026-02-20T00:55:29.263Z",
    "edited_at": "2026-02-20T00:55:29.263Z"
  },
  "meta": {},
  "errors": {
    "ANY_ADDITIONAL_PROPERTY": [
      "text"
    ]
  },
  "is_error": true
}