---
title: "Retrieve a person"
method: GET
path: "/persons/{id}"
tags: ["customers"]
---

# Retrieve a person

`GET /persons/{id}`

Retrieve a person by ID.

## Path parameters

- `id` string, required — The ID of the person.

## Response `200`

OK

- union
  - NaturalPerson
    - `address` Address, required
      - `city` string, required — City or locality.
      - `country_code` string, required — ISO 3166-1 alpha-2 country code.
      - `district_county` string, nullable, required — District or county.
      - `line1` string, required — Primary street address line.
      - `line2` string, nullable, required — Additional street address line.
      - `line3` string, nullable, required — Further street address line.
      - `postal_code` string, required — Postal code.
    - `created_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was created.
    - `date_of_birth` string, date, nullable, required — Person's date of birth.
    - `first_name` string, nullable, required — Person's first name.
    - `full_name` string, required — Full name: first and last for natural persons, entity name for legal persons.
    - `id` string, required — Unique resource identifier.
    - `id_number` string, nullable, required — Masked national identity number.
    - `last_name` string, nullable, required — Person's last name.
    - `modified_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was last modified.
    - `nationalities` string[], required — ISO 3166-1 alpha-2 nationality codes.
    - `passport_number` string, nullable, required — Masked passport number.
    - `person_type` 'natural', required — Person classification.
    - `phone_number` string, nullable, required — Person's primary phone number.
    - `tax_number` string, nullable, required — Masked tax identification number.
  - LegalPerson
    - `address` Address, required
      - `city` string, required — City or locality.
      - `country_code` string, required — ISO 3166-1 alpha-2 country code.
      - `district_county` string, nullable, required — District or county.
      - `line1` string, required — Primary street address line.
      - `line2` string, nullable, required — Additional street address line.
      - `line3` string, nullable, required — Further street address line.
      - `postal_code` string, required — Postal code.
    - `created_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was created.
    - `entity_name` string, nullable, required — Registered legal entity name.
    - `entity_type` 'limited_company' | 'partnership' | 'sole_proprietorship' | 'foundation' | 'trust' | 'cooperative' | 'other', required
    - `full_name` string, required — Full name: first and last for natural persons, entity name for legal persons.
    - `id` string, required — Unique resource identifier.
    - `lei_code` string, nullable, required — Legal Entity Identifier.
    - `lei_code_expiry_date` string, date, nullable, required — Expiry date of the Legal Entity Identifier.
    - `modified_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was last modified.
    - `operating_address` Address, required
      - `city` string, required — City or locality.
      - `country_code` string, required — ISO 3166-1 alpha-2 country code.
      - `district_county` string, nullable, required — District or county.
      - `line1` string, required — Primary street address line.
      - `line2` string, nullable, required — Additional street address line.
      - `line3` string, nullable, required — Further street address line.
      - `postal_code` string, required — Postal code.
    - `person_type` 'legal', required — Person classification.
    - `phone_number` string, nullable, required — Person's primary phone number.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/joinsophic/apis/sophic-engine-api.md) · [All operations](https://skmtc.net/joinsophic/apis/sophic-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/joinsophic/sophic-engine-api/versions/250f4b477cbf/schema)