---
title: "List Person Data Update Requests"
method: GET
path: "/persons/{person_id}/updates"
tags: ["Persons"]
---

# List Person Data Update Requests

`GET /persons/{person_id}/updates`

## Request

- Base URL: `https://sandbox.api.lemon.markets/v1`
- URL: `https://sandbox.api.lemon.markets/v1/persons/{person_id}/updates`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/docs/persons/:person_id/updates/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `person_id` string, required

## Query parameters

- `cursor` string
- `limit` integer

## Headers

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

## Response `200`

Successful Response

- EncodedPaginatedCollectionResponsePersonDataUpdateAnnotatedResponse: A paginated collection of person data update requests.
  - `data` PersonDataUpdateAnnotatedResponse[], required: The elements of the response.
    - `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.
  - `pagination` EncodedPaginationResponse, required: Information about accessing elements beyond the ones that were returned.
    - `next_cursor` string: When fetching long lists of elements, you can use our pagination feature to fetch batches of data. If a response contains the property `pagination.next_cursor`, you can pass its value via the query item `cursor` to generate the request for the next batch of data.

## Other responses

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

---

[API](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api.md) - [All operations](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/revisions/1f1df208c0e4?raw)