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

# Beneficiaries

> Create and manage payout recipients

Beneficiaries are saved payout recipients scoped to your integrator workspace. Create them once; reference by ID in quotes and transactions.

See [Beneficiaries concepts](/concepts/beneficiaries) for data model details.

## Endpoints

| Method   | Path                        | Description                          |
| -------- | --------------------------- | ------------------------------------ |
| `POST`   | `/v1/api/beneficiaries`     | Create a new beneficiary             |
| `GET`    | `/v1/api/beneficiaries`     | List beneficiaries for the workspace |
| `GET`    | `/v1/api/beneficiaries/:id` | Get a beneficiary by ID              |
| `PATCH`  | `/v1/api/beneficiaries/:id` | Update a beneficiary                 |
| `DELETE` | `/v1/api/beneficiaries/:id` | Deactivate a beneficiary             |