# /beneficiary

Updates an existing beneficiary's information.
## Purpose
Allows modification of a beneficiary's personal details, contact information, and address. Only fields included in the request will be updated; omitted fields retain their current values.
## Authentication
Requires `x-client-id` and `x-secret-key` headers.

Endpoint: PUT /beneficiary
Version: 1.0.0

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

## Request fields (application/json):

  - `uuid` (string, required)
    UUID of the beneficiary to update.
Error codes: required=400001, type=400002, minLength=400003, maxLength=400004

  - `firstName` (string)
    Beneficiary's given name.
Error codes: type=400002, minLength=400003, maxLength=400004

  - `middleName` (string)
    Beneficiary's middle name.
Error codes: type=400002, minLength=400003, maxLength=400004

  - `lastName` (string)
    Beneficiary's primary family name.
Error codes: type=400002, minLength=400003, maxLength=400004

  - `secondLastName` (string)
    Beneficiary's second family name.
Error codes: type=400002, minLength=400003, maxLength=400004

  - `phone` (string)
    Beneficiary's phone number without country code.
Error codes: type=400002, minLength=400003, maxLength=400004

  - `phoneCountryCode` (string)
    International dialing code.
Error codes: type=400002, minLength=400003, maxLength=400004

  - `email` (string)
    Beneficiary's email.
Error codes: type=400002, minLength=400003, maxLength=400004, format=400005

  - `addressStreet` (string)
    Beneficiary address.
Error codes: type=400002, minLength=400003, maxLength=400004

  - `addressStreet2` (string)
    Secondary address line.
Error codes: type=400002, minLength=400003, maxLength=400004

  - `addressCity` (string)
    City of residence.
Error codes: type=400002, minLength=400003, maxLength=400004

  - `addressCountry` (string)
    Country (ISO 3).
Error codes: type=400002, minLength=400003, maxLength=400004

  - `addressZipCode` (string)
    ZIP code.
Error codes: type=400002, minLength=400003, maxLength=400004

  - `relationShip` (string)
    Relationship between sender and beneficiary.
See [Catalogs Endpoint RelationShips](/apis/outbound/catalogs/paths/~1catalogs~1recipients~1relationships/get)
Error codes: type=400002, minLength=400003, maxLength=400004

  - `documentType` (string)
    Type of identification document of the beneficiary.
You can check the types of documents available according to the beneficiary's country in our catalogs API:
Catalogs Endpoint Identifications: GET /catalogs/countries/{deliveryCountryISO}/identifications
Error codes: type=400002, minLength=400003, maxLength=400004

  - `documentNumber` (string)
    Identification document number of the beneficiary.
Error codes: type=400002, minLength=400003, maxLength=400004

  - `documentDescription` (string)
    Human-readable description of the identification document.
Error codes: type=400002, minLength=400003, maxLength=400004

  - `documentExpirationDate` (string)
    Expiration date of the beneficiary's identification document.
Format: YYYY-MM-DD
Error codes: type=400002, minLength=400003, maxLength=400004, format=400005

  - `documentCountry` (string)
    Country that issued the beneficiary's identification document (ISO 3). https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3
Error codes: type=400002, minLength=400003, maxLength=400004

## Response 200 fields (application/json):

  - `status` (string)

  - `message` (string)

  - `uuid` (string)
    UUID of the updated beneficiary.

## Response 400 fields (application/json):

  - `errors` (array)
    Error catalog for 400 (click to expand)CodeDescription400001uuid is required.400003Field does not meet minimum length requirement.400004Field exceeds maximum length.400005Invalid email format.

  - `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 500 fields (application/json):

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

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)