---
title: "Create Person Data Update Request"
method: POST
path: "/persons/{person_id}/updates"
tags: ["Persons"]
---

# Create Person Data Update Request

`POST /persons/{person_id}/updates`

## Path parameters

- `person_id` string, required

## Headers

- `LMG-Data-Privacy-Access-Principal` string, required
- `LMG-Data-Privacy-Access-Justification` string, required

## Request body

- union — A request to update a single person data field. The payload contains the type of data being updated and the new value(s).
  - PersonDataUpdateEmailRequest — A request to update a person's email address.
    - `type` 'email', required — The type discriminator identifying this as an email update request.
    - `email` string, email, required — The new email address for the person.
  - PersonDataUpdatePhoneNumberRequest — A request to update a person's phone number.
    - `type` 'phone_number', required — The type discriminator identifying this as a phone number update request.
    - `number` string, required — The new phone number for the person, including the country calling code.
  - PersonDataUpdateRegisteredAddressRequest — A request to update a person's registered address.
    - `type` 'registered_address', required — The type discriminator identifying this as a registered address update request.
    - `line_1` string, required — The first line of the address, typically containing the street name and number.
    - `line_2` string, nullable — An optional second line of the address, for additional address details.
    - `postal_code` string, required — The postal code or ZIP code of the address.
    - `city` string, required — The city or municipality of the address.
    - `country` string, required — An ISO 3166-1 alpha-2 code representing the country of the address.
  - PersonDataUpdateEmploymentRequest — A request to update a person's employment information.
    - `type` 'employment', required — The type discriminator identifying this as an employment information update request.
    - `status` 'apprenticeship' | 'company_owner' | 'employed' | 'managing_director' | 'public_official' | 'retired' | 'self_employed' | 'student' | 'unemployed', required — A category to represent a user's employment status: <ul> <li><code>apprenticeship</code> <li><code>company_owner</code> <li><code>employed</code> <li><code>managing_director</code> <li><code>public_official</code> <li><code>retired</code> <li><code>self_employed</code> <li><code>student</code> <li><code>unemployed</code> </ul>
    - `annual_salary` 'lt_50k_eur' | 'gte_50k_lt_75k_eur' | 'gte_75k_lt_100k_eur' | 'gte_100k_lt_150k_eur' | 'gte_150k_eur', required — A category to represent a customer's annual income: <ul> <li><code>lt_50k_eur</code>: Less than 50,000 EUR. <li><code>gte_50k_lt_75k_eur</code>: 50,000 EUR or more, but less than 75,000 EUR. <li><code>gte_75k_lt_100k_eur</code>: 75,000 EUR or more, but less than 100,000 EUR. <li><code>gte_100k_lt_150k_eur</code>: 100,000 EUR or more, but less than 150,000 EUR. <li><code>gte_150k_eur</code>: 150,000 EUR or more. </ul>
    - `sector` 'agriculture' | 'commodities' | 'construction' | 'education' | 'financial_services' | 'gambling' | 'healthcare' | 'it' | 'jewellery_trading' | 'manufacturing' | 'precious_metals_trading' | 'professional_services' | 'public_sector' | 'real_estate' | 'retail' | 'service_industry' | 'sport' | 'tourism' | 'transport' | 'used_vehicles_trading' | 'weapons_trading' | 'other', required — A category representing the industry sector related to a user's employment status. If the user's employment status is not directly linked to a sector, select `other`. <ul> <li><code>agriculture</code></li> <li><code>commodities</code></li> <li><code>construction</code></li> <li><code>education</code></li> <li><code>financial_services</code></li> <li><code>gambling</code></li> <li><code>healthcare</code></li> <li><code>it</code></li> <li><code>jewellery_trading</code></li> <li><code>manufacturing</code></li> <li><code>precious_metals_trading</code></li> <li><code>professional_services</code></li> <li><code>public_sector</code></li> <li><code>real_estate</code></li> <li><code>retail</code></li> <li><code>service_industry</code></li> <li><code>sport</code></li> <li><code>tourism</code></li> <li><code>transport</code></li> <li><code>used_vehicles_trading</code></li> <li><code>weapons_trading</code></li> <li><code>other</code></li> </ul>
  - PersonDataUpdateTaxResidenciesRequest — A request to update a person's tax residencies (self-declared TINs). Provide the complete list of tax residencies for the person (the list replaces the current set, so include all existing and new entries, not just the new one). Each country must appear at most once.
    - `type` 'tax_residencies', required — The type discriminator identifying this as a tax residency update request.
    - `residencies` PersonDataUpdateTaxResidency[], required — The complete list of tax residencies and TINs for the person.
      - `country` string, required — An ISO 3166-1 alpha-2 code representing the tax residency country.
      - `tax_identification_number` string, required — The TIN (Tax Identification Number) for the person in the given country.

## Response `201`

Successful Response

- PersonDataUpdateAnnotatedResponse — An object representing a person data update request with the specific data being updated.
  - `id` string, required — A unique identifier for the person data update request.
  - `type` 'email' | 'phone_number' | 'registered_address' | 'employment' | 'tax_residencies', required — The discriminator identifying which field is being updated.
  - `email` string, email — The new email address for the person when `type` is `email`.
  - `number` string — The new phone number for the person, including the country calling code, when `type` is `phone_number`.
  - `line_1` string — The first line of the address when `type` is `registered_address`.
  - `line_2` string, nullable — An optional second line of the address when `type` is `registered_address`.
  - `postal_code` string — The postal code or ZIP code of the address when `type` is `registered_address`.
  - `city` string — The city or municipality of the address when `type` is `registered_address`.
  - `country` string — An ISO 3166-1 alpha-2 code representing the country when `type` is `registered_address`.
  - `status` 'apprenticeship' | 'company_owner' | 'employed' | 'managing_director' | 'public_official' | 'retired' | 'self_employed' | 'student' | 'unemployed' — A category to represent a user's employment status: <ul> <li><code>apprenticeship</code> <li><code>company_owner</code> <li><code>employed</code> <li><code>managing_director</code> <li><code>public_official</code> <li><code>retired</code> <li><code>self_employed</code> <li><code>student</code> <li><code>unemployed</code> </ul>
  - `annual_salary` 'lt_50k_eur' | 'gte_50k_lt_75k_eur' | 'gte_75k_lt_100k_eur' | 'gte_100k_lt_150k_eur' | 'gte_150k_eur' — A category to represent a customer's annual income: <ul> <li><code>lt_50k_eur</code>: Less than 50,000 EUR. <li><code>gte_50k_lt_75k_eur</code>: 50,000 EUR or more, but less than 75,000 EUR. <li><code>gte_75k_lt_100k_eur</code>: 75,000 EUR or more, but less than 100,000 EUR. <li><code>gte_100k_lt_150k_eur</code>: 100,000 EUR or more, but less than 150,000 EUR. <li><code>gte_150k_eur</code>: 150,000 EUR or more. </ul>
  - `sector` 'agriculture' | 'commodities' | 'construction' | 'education' | 'financial_services' | 'gambling' | 'healthcare' | 'it' | 'jewellery_trading' | 'manufacturing' | 'precious_metals_trading' | 'professional_services' | 'public_sector' | 'real_estate' | 'retail' | 'service_industry' | 'sport' | 'tourism' | 'transport' | 'used_vehicles_trading' | 'weapons_trading' | 'other' — A category representing the industry sector related to a user's employment status. If the user's employment status is not directly linked to a sector, select `other`. <ul> <li><code>agriculture</code></li> <li><code>commodities</code></li> <li><code>construction</code></li> <li><code>education</code></li> <li><code>financial_services</code></li> <li><code>gambling</code></li> <li><code>healthcare</code></li> <li><code>it</code></li> <li><code>jewellery_trading</code></li> <li><code>manufacturing</code></li> <li><code>precious_metals_trading</code></li> <li><code>professional_services</code></li> <li><code>public_sector</code></li> <li><code>real_estate</code></li> <li><code>retail</code></li> <li><code>service_industry</code></li> <li><code>sport</code></li> <li><code>tourism</code></li> <li><code>transport</code></li> <li><code>used_vehicles_trading</code></li> <li><code>weapons_trading</code></li> <li><code>other</code></li> </ul>
  - `residencies` PersonDataUpdateTaxResidency[] — The list of tax residencies and TINs when `type` is `tax_residencies`.
    - `country` string, required — An ISO 3166-1 alpha-2 code representing the tax residency country.
    - `tax_identification_number` string, required — The TIN (Tax Identification Number) for the person in the given country.
  - `history` StatusChangePersonDataUpdateRequestStatus[], required — A chronological list of status changes for this update request.
    - `status` 'created' | 'processing' | 'success' | 'failure', required — A category representing the status of a person data update request. <ul> <li><code>created</code> - The update request has been created <li><code>processing</code> - The update request is being processed <li><code>success</code> - The update request has been successfully completed <li><code>failure</code> - The update request has failed </ul>
    - `timestamp` string, date-time, required — The timestamp at which this status change occurred.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `5XX` — Server Error

---

[API](https://skmtc.net/lemon/apis/lemon-markets-brokerage-api.md) · [All operations](https://skmtc.net/lemon/apis/lemon-markets-brokerage-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lemon/lemon-markets-brokerage-api/versions/3c8cfd3a96c9/schema)