Overview The Delete Transfer endpoint allows you to remove individual transfers from a bulk transfer batch that hasn’t been executed. This is useful for correcting errors or removing unnecessary transfers before batch execution.
You can only delete transfers from batches that are in the created status. Once a batch is executing or completed, transfers cannot be deleted.
Endpoint DELETE /bulk-transfers/{batch_id}/transfers/{id} Path Parameters The unique identifier of the bulk transfer batch
Must be a valid UUID
Batch must be in created status
The unique identifier of the transfer to delete
Must be a valid UUID
Transfer must be part of the specified batch
Request Example curl -X DELETE "https://api.spendjuice.com/bulk-transfers/88dbcb86-5025-4ac9-9750-4aa5a77a723c/transfers/e2df31d2-828e-11ef-8f08-acde48001122" \ -H "Authorization: YOUR_API_KEY"
Response A successful delete operation returns an HTTP 204 (No Content) response with no response body.
Error Responses
{ "error" : { "code" : "invalid_request" , "message" : "Invalid batch or transfer ID format" } }
{ "error" : { "code" : "not_found" , "message" : "Transfer or batch not found" } }
{ "error" : { "code" : "invalid_state" , "message" : "Cannot delete transfer from batch in current status" } } Validation Rules
Batch Status
Only transfers in batches with created status can be deleted
Deletion blocked if batch is executing/completed
Batch must belong to your account
Transfer Requirements
Transfer must exist in the specified batch
Transfer must not be in processing state
Transfer ID must be valid format
Status Impact Deleting a transfer:
Reduces the batch’s total transfer count
Updates batch metadata
Cannot be undone - requires re-adding if needed
Does not affect other transfers in the batch
Best Practices
Validation
Verify batch and transfer status before deletion
Handle expected error cases gracefully
Log deletion attempts for audit purposes
Error Handling
Implement retry logic for network errors
Show clear error messages to users
Monitor deletion success rates
Security
Validate user permissions
Log all deletion operations
Implement rate limiting
Use HTTPS for all requests
Need Help? For additional assistance:
Responses are generated using AI and may contain mistakes.