Delete Beneficiary

Remove a saved beneficiary. This is a soft delete — the beneficiary will no longer appear in listings but historical disbursements referencing it are preserved.

Endpoint

DELETE /v1/beneficiaries/:id

Path Parameters

Parameter	Description
id	Beneficiary UUID

Example

cURL

curl -X DELETE https://api.nusio-saka.com/v1/beneficiaries/550e8400-e29b-41d4-a716-446655440000 \
  -H "X-API-Key: your-api-key"

Response

HTTP 200 OK

{
  "success": true,
  "data": {
    "deleted": true
  }
}

Error Codes

Code	HTTP	Description
INVALID_ID	400	Not a valid UUID
BENEFICIARY_NOT_FOUND	404	No beneficiary with this ID