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

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

Authorizations

Path parameters

batch_referencestringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v1/transfers/batch/requeue-failed/{batch_reference}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

{
  "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-02-20T19:24:46.180Z",
    "otp_validated": true,
    "otp_validated_at": "2025-02-20T19:24:46.180Z",
    "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-02-20T19:24:46.180Z",
    "edited_at": "2025-02-20T19:24:46.180Z"
  },
  "meta": {},
  "is_error": true,
  "errors": {
    "ANY_ADDITIONAL_PROPERTY": [
      "text"
    ]
  }
}

Success