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

# Retrieve a customer

`GET /customers/{id}`

Retrieve a customer by ID.

## Path parameters

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

## Response `200`

OK

- union
  - IndividualCustomer
    - `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.
    - `customer_type` 'individual', required — Customer classification.
    - `date_of_birth` string, date-time, nullable, required — Customer's date and time of birth.
    - `first_name` string, required — Customer's first name.
    - `full_name` string, required — Customer's full display name.
    - `id` string, required — Unique resource identifier.
    - `id_number` string, nullable, required — Masked national identity number.
    - `last_name` string, required — Customer's last name.
    - `mifid_category` string, nullable, required — Customer's MiFID classification.
    - `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[], nullable, required — ISO 3166-1 alpha-2 nationality codes.
    - `onboarding` string, nullable, required — ID of the customer's onboarding process.
    - `passport_number` string, nullable, required — Masked passport number.
    - `phone_number` string, nullable, required — Customer's primary phone number.
    - `reference` string, nullable, required — Customer-visible reference.
    - `referrer_code` string, nullable, required — Referral code associated with the customer.
    - `risk_profile` string, nullable, required — Customer's assigned risk profile.
    - `risk_score` string, nullable, required — Customer's risk score.
    - `status` 'active' | 'suspended' | 'closing' | 'closed', required
    - `tax_number` string, nullable, required — Masked tax identification number.
  - JointCustomer
    - `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.
    - `customer_type` 'joint', required — Customer classification.
    - `first_name` string, nullable, required — Combined first names of the joint owners.
    - `full_name` string, required — Customer's full display name.
    - `id` string, required — Unique resource identifier.
    - `last_name` string, nullable, required — Combined last names of the joint owners.
    - `mifid_category` string, nullable, required — Customer's MiFID classification.
    - `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.
    - `onboarding` string, nullable, required — ID of the customer's onboarding process.
    - `phone_number` string, nullable, required — Customer's primary phone number.
    - `reference` string, nullable, required — Customer-visible reference.
    - `referrer_code` string, nullable, required — Referral code associated with the customer.
    - `risk_profile` string, nullable, required — Customer's assigned risk profile.
    - `risk_score` string, nullable, required — Customer's risk score.
    - `status` 'active' | 'suspended' | 'closing' | 'closed', required
  - BusinessCustomer
    - `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.
    - `customer_type` 'business', required — Customer classification.
    - `entity_name` string, required — Registered business name.
    - `entity_type` string, nullable, required — Legal form of the business.
    - `full_name` string, required — Customer's full display name.
    - `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.
    - `mifid_category` string, nullable, required — Customer's MiFID classification.
    - `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.
    - `onboarding` string, nullable, required — ID of the customer's onboarding process.
    - `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.
    - `phone_number` string, nullable, required — Customer's primary phone number.
    - `reference` string, nullable, required — Customer-visible reference.
    - `referrer_code` string, nullable, required — Referral code associated with the customer.
    - `risk_profile` string, nullable, required — Customer's assigned risk profile.
    - `risk_score` string, nullable, required — Customer's risk score.
    - `status` 'active' | 'suspended' | 'closing' | 'closed', required

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