Skip to main content
DELETE
/
v1
/
recipients
/
{id}
Delete recipient
curl --request DELETE \
  --url https://api.daya.co/v1/recipients/{id} \
  --header 'X-Api-Key: <x-api-key>'
(empty response body)

​
Overview

Soft-delete a payout recipient. The recipient will no longer appear in list results and cannot be used for new payouts. This action is irreversible.

​
Authentication

​
X-Api-Key
string
required
Your merchant API key

​
Path Parameters

​
id
string
required
Recipient ID (UUID)Example: 750e8400-e29b-41d4-a716-446655440000

​
Request Example

curl --request DELETE \
  --url https://api.daya.co/v1/recipients/750e8400-e29b-41d4-a716-446655440000 \
  --header 'X-Api-Key: YOUR_API_KEY'

​
Response

A successful deletion returns a 204 No Content response with an empty body.

​
Success Response

(empty response body)

​
Error Responses

{
  "error": {
    "code": "validation_failed",
    "message": "Invalid UUID format"
  }
}

​
Notes

  • This is a soft-delete operation. The recipient record is retained internally but is no longer accessible via the API.
  • Any in-progress payouts referencing this recipient will not be affected.
  • Deleting a recipient that has already been deleted will return a 404 Not Found error.

​
Next Steps

Create recipient

Create a new payout recipient

List recipients

Retrieve all saved payout recipients