# Get beneficiary

**GET /api/v1/beneficiaries/{beneficiaryId}**

Returns a confirmed beneficiary 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.


### Path parameters

- **beneficiaryId** (string)
  Beneficiary id returned by the beneficiary list endpoint.




## Responses
### 200
Beneficiary returned successfully

#### Body: application/json (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.


### 404
Beneficiary was not found for the authenticated user

#### Body: application/json (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)