> ## 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.

# Get Beneficiary

> Fetch a single beneficiary, including its nested payment destinations

Fetches a single beneficiary, including its nested `payment_destinations` array (available destinations only). There is no request body.

## 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. Key fields:

<ResponseField name="status" type="enum">
  `active` | `disabled`.
</ResponseField>

<ResponseField name="verified" type="bool">
  Whether the beneficiary has been verified. Not client-editable.
</ResponseField>

<ResponseField name="payment_destinations" type="PaymentDestination[]">
  Nested payment destinations owned by this beneficiary. Account fields are masked (the client never sees full account numbers). See the Payment Destinations section for the full object.
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "object": "beneficiary",
    "id": "bene_9f2c1d7e8a4bx0y1z2a3b4c5",
    "account_id": "acct_4d8e2a1b9c3fx0y1z2a3b4c5",
    "beneficiary_type": "business",
    "title": null,
    "first_name": null,
    "middle_name": null,
    "last_name": null,
    "display_name": "Globex Ltd",
    "company_name": "Globex Limited",
    "email": "ap@globex.example",
    "phone": null,
    "address": {
      "address_line": "5 King St",
      "city": "London",
      "region": "London",
      "postal_code": "EC2V 8AS",
      "country": "GB"
    },
    "country_code": "GB",
    "status": "active",
    "verified": true,
    "payment_destinations": [
      {
        "object": "payment_destination",
        "id": "dest_7a3b9c1e5f2dx0y1z2a3b4c5",
        "beneficiary_id": "bene_9f2c1d7e8a4bx0y1z2a3b4c5",
        "type": "bank_account",
        "country": "GB",
        "currency": "GBP",
        "label": "Globex GBP",
        "status": "active",
        "payment_method": "wire",
        "iban_masked": "GB29****6819",
        "is_default": true,
        "created": "2026-06-10T10:00:00Z",
        "updated": null
      }
    ],
    "created": "2026-06-10T09:15:00Z",
    "updated": "2026-06-10T10:00:00Z",
    "created_by": "ak_x7k2m9p4q1w8e5r3t6y0u2i4",
    "updated_by": null
  }
  ```
</ResponseExample>
