---
title: "List Persons"
method: GET
path: "/persons"
tags: ["Persons"]
---

# List Persons

`GET /persons`

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

- EncodedPaginatedCollectionResponsePersonResponse
  - `data` BrokerAppsApiEndpointsPersonsPersonResponse[], required — The elements of the response.
    - `id` string, required — The identifier representing this person.
    - `firstname` string, required — A string describing the person's first name.
    - `lastname` string, required — A string describing the person's lastname.
    - `date_of_birth` string, date, required — A string describing the day of birth, like `"1964-08-13"`.
    - `registered_address` Address, required — A residential address.
      - `line_1` string, required — The first line of the address. For most German addresses, this will be the street name and house number. If there is only a street name or a house number, provide that one without the other.
      - `line_2` string — The second line of the address. This field is optional, and it won't be needed for most German addresses. For care-of addresses (℅) like the following, this is likely to be the actual street name and house number: <br/> * Erika Mustermann<br/>℅ Max Müller<br/>**Mustergasse 14**<br/>12345 Musterstadt<br/>Germany
      - `postal_code` string, required — The postal code for the address.
      - `city` string, required — The city/municipality of the address.
      - `country` string, required — An ISO 3166-1 alpha-2 code, representing the country of the address.
    - `nationalities` string[] — A **complete** list of ISO 3166-1 alpha-2 codes, representing each country related to a user's nationalities/citizenships. It is important for this data point to be complete.
    - `email` string — A verified email address to contact the user. This email address must match the one you have on record for the user.
    - `phone_number` string — A mobile phone number, including the country calling code.
    - `place_of_birth` PlaceOfBirthRequest — An object representing a place of birth.
      - `city` string, required — The city/municipality of the place of birth.
      - `country` string, required — An ISO 3166-1 alpha-2 code, representing the country related to the place of birth.
    - `tax_residencies` TaxResidency[] — A **complete** list of all of a user's tax residencies. It is important for this data point to be complete.
      - `country` string, required — An ISO 3166-1 alpha-2 code, representing a country considering the user one of its tax payers.
      - `tax_identification_number` string — The TIN (Tax Identification Number) related to the user within the taxation regime within `country`.
  - `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.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)