API Reference

The following endpoint retrieves the details of the disbursement created

Batch Status Enum

This section provides details on batch-level statuses when retrieving a disbursement by ID. Use these references to understand and handle the status field more effectively.

Status Values

StatusDescription
draftThe batch was created but not yet finalized. Typically, additional steps—such as adding recipient details—may be needed before progressing.
need_approvalThe batch is pending approval. It requires a review by an administrator or an automated process before it can move on.
approvedThe batch has been approved and can now proceed to the next stage in the disbursement workflow.
partially_successSome transactions in the batch succeeded, while others failed. You can inspect individual failures and attempt to resolve or retry them without impacting those that succeeded.
successAll transactions in the batch were processed successfully. No additional action is required, though you may still review transaction details for record-keeping.
failedThe batch failed entirely. Review error messages or logs to determine the failure point and retry if appropriate.
need_revisionThe batch requires changes before it can proceed. This might be triggered by validation errors (e.g., incorrect amounts or missing info). Update the necessary fields and resubmit for approval if your workflow requires it.
Language
Credentials
Basic
base64
:
Click Try It! to start a request and see the response here!