---
title: "Delete a Cross-border Beneficiary"
method: DELETE
path: "/api/b2b/cross-border/requests/beneficiaries/{id}"
tags: ["Cross-border Requests"]
---

# Delete a Cross-border Beneficiary

`DELETE /api/b2b/cross-border/requests/beneficiaries/{id}`

## Request

- Base URL: `https://api-v2.honeycoin.app`
- URL: `https://api-v2.honeycoin.app/api/b2b/cross-border/requests/beneficiaries/{id}`
- Auth: API key in header `Authorization`

Soft-delete an owned beneficiary. Do not delete a beneficiary needed by an unfinished request.

## Path parameters

- `id` string, required

## Response `200`

Successful response.

- object
  - `success` boolean, required
  - `message` string, required

## Other responses

- `400`: Invalid input.
- `403`: Resource belongs to another account.
- `404`: Resource not found.
- `409`: Duplicate or incompatible state.
- `422`: Missing documents or invalid lifecycle state.

## Changes

- **2026-11-03** `fcb58b0ef441`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/changes/api/b2b/cross-border/requests/beneficiaries/:id/delete.md)

---

[API](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official.md) - [All operations](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/llms.txt) - [OpenAPI document](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/revisions/fcb58b0ef441?raw)