# List beneficiaries

**GET /api/v1/beneficiaries**

Returns confirmed beneficiaries belonging to the authenticated API key owner.


## Servers
- https://api.lumetrade.com: https://api.lumetrade.com ()



## Parameters
### Headers

- **X-API-KEY** (string)
  Public API key issued from the Lumetrade API key management flow.

- **X-API-SECRET** (string)
  API secret paired with the public API key.



### Query parameters

- **currency** (string)
  Optional beneficiary currency code filter.



## Responses
### 200
Beneficiaries returned successfully

#### Body: application/json (array[object])
- **id** (string)
  Beneficiary id used by external beneficiary endpoints.

- **currency** (string)
  Saved beneficiary currency.

- **nickname** (string)
  Beneficiary nickname.

- **withdrawFormDetails** (object)
  Raw withdrawal details stored as JSON object.

- **createdAt** (string(date-time))
  Beneficiary creation timestamp.



[Powered by Bump.sh](https://bump.sh)