---
title: "Delete crypto Beneficiary by Id"
method: DELETE
path: "/ledger/crypto-beneficiaries/{beneficiaryId}"
tags: ["ledger-beneficiaries"]
---

# Delete crypto Beneficiary by Id

`DELETE /ledger/crypto-beneficiaries/{beneficiaryId}`

This operation allows the client to delete a crypto beneficiary by its Id

## Path parameters

- `beneficiaryId` string, uuid, required

## Response `200`

Beneficiary deleted successfully

- StatusDto — Status data, check additional message field.
  - `success` boolean, required — Status can be successful or failed, a value of true indicates success.
  - `message` string — additional message describing status.
  - `data` object — Data associated with the status, this will not always be present
  - `error` ErrorMessageDto — Default error object for services. This gives consistent error object that all services may use.
    - `code` string, required — Error code
    - `message` string, required — Descriptive error message
    - `data` object — Additional data for this error message.

## Other responses

- `400` — Request could not be validated
- `401` — Client is not authorized to make request
- `403` — Expected permission is not available.
- `default` — Internal Server Error

---

[API](https://skmtc.net/nestechops/apis/onboard-external-api-gateway.md) · [All operations](https://skmtc.net/nestechops/apis/onboard-external-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nestechops/onboard-external-api-gateway/revisions/29661adc1ffc/schema)