> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.hopnow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Disable Beneficiary

> Disable a beneficiary so no future payments can be sent to it

Disables a beneficiary. No future payments are allowed to a disabled beneficiary, but it remains visible in listings. The request takes the path `id` with an empty body.

<Note>
  Disable is the way to retire a beneficiary — there is no hard delete on this API.
</Note>

## Path Parameters

<ParamField path="account_id" type="string" required>
  Id of the parent account (e.g. `acct_...`).
</ParamField>

<ParamField path="id" type="string" required>
  Beneficiary id (e.g. `bene_...`).
</ParamField>

## Response

Returns 200 with the beneficiary object, where `status` is `disabled`.

<ResponseExample>
  ```json Response theme={null}
  {
    "object": "beneficiary",
    "id": "bene_9f2c1d7e8a4bx0y1z2a3b4c5",
    "account_id": "acct_4d8e2a1b9c3fx0y1z2a3b4c5",
    "beneficiary_type": "business",
    "display_name": "Globex UK",
    "company_name": "Globex Limited",
    "country_code": "GB",
    "status": "disabled",
    "verified": true,
    "payment_destinations": [],
    "created": "2026-06-10T09:15:00Z",
    "updated": "2026-06-12T14:05:00Z",
    "created_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4",
    "updated_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4"
  }
  ```
</ResponseExample>