# /beneficiary

Retrieves a beneficiary by its UUID.
## Purpose
Returns the details of a specific beneficiary. Optionally validates that the beneficiary belongs to a given sender.
## Query Parameters
- `uuid` (required): UUID of the beneficiary to retrieve
- `senderUuid` (optional): If provided, verifies the beneficiary belongs to this sender

## Authentication
Requires `x-client-id` and `x-secret-key` headers.

Endpoint: GET /beneficiary
Version: 1.0.0

## Query parameters:

  - `uuid` (string, required)
    UUID of the beneficiary to retrieve.

Error codes: required=400001, type=400002, minLength=400003, maxLength=400004

  - `senderUuid` (string)
    UUID of the sender. If provided, verifies the beneficiary belongs to this sender before returning it.

Error codes: type=400002, minLength=400003, maxLength=400004

## Header parameters:

  - `x-client-id` (string, required)
    Client identifier.

Error codes: required=400001, type=400002, minLength=400003, maxLength=400004

  - `x-secret-key` (string, required)
    Secret key.

Error codes: required=400001, type=400002, minLength=400003, maxLength=400004

## Response 200 fields (application/json):

  - `status` (string)
    Result status (`success`).

  - `message` (string)
    Confirmation message.

  - `data` (object)
    Beneficiary object with personal, contact, and address information.

## Response 400 fields (application/json):

  - `errors` (array)
    Error catalog for 400 (click to expand)CodeDescription400001uuid query parameter is required.

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)

## Response 401 fields (application/json):

  - `errors` (array)
    Error catalog for 401 (click to expand)CodeDescription401000Invalid credentials.

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)

## Response 404 fields (application/json):

  - `errors` (array)
    Error catalog for 404 (click to expand)CodeDescription404000Beneficiary not found, or does not belong to the specified sender.

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)

## Response 500 fields (application/json):

  - `errors` (array)
    Error catalog for 500 (click to expand)CodeDescription500000Internal server error.

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)