---
title: "GET /api/v1/customers/{customerId}"
method: GET
path: "/api/v1/customers/{customerId}"
tags: ["Customers"]
---

# GET /api/v1/customers/{customerId}

`GET /api/v1/customers/{customerId}`

Get customer details by ID including KYC status

## Path parameters

- `customerId` string, uuid, required — Customer UUID

## Response `200`

Default Response

- GetCustomerResponse
  - `customer_id` string, uuid, required — Customer UUID
  - `external_customer_id` string, nullable, required
  - `customer_type` 'individual' | 'business', required — Type of customer in display format
  - `email` string, email, required
  - `phone` string, e164 — Phone number in E.164 format (e.g., +14155552671)
  - `entitlements` object[] — Feature-based entitlements for the customer with status
    - `name` string, required — Entitlement name
    - `status` 'submitted' | 'in_progress' | 'approved' | 'rejected', required — Entitlement status in display format
  - `first_name` string — First name (for individuals)
  - `last_name` string — Last name (for individuals)
  - `company_name` string — Company name (for businesses)
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `metadata` Metadata
  - `verification_levels` VerificationLevelResponse[], required — All KYC level records for this customer
    - `level` 'kyc_level_0' | 'kyc_level_1' | 'kyc_level_2' | 'base_business' | 'individual_base' | 'business_base' | 'individual_enhanced', required — KYC verification level in display format
    - `status` 'in_progress' | 'approved' | 'rejected' | 'requires_action', required — KYC verification status in display format
    - `sub_status` string[] — Optional list of sub-status reasons for this verification level
  - `status` string — Customer compliance status
  - `compliance_lock` object — Active compliance lock details, present when customer is locked
    - `locked_at` string, date-time, required
    - `locked_by_user_id` string, required
    - `locked_by_user_name` string, nullable
    - `locked_by_user_email` string, nullable
    - `lock_reason` string, required

## Other responses

- `404` — Default Response

---

[API](https://skmtc.net/stables/apis/stables-api.md) · [All operations](https://skmtc.net/stables/apis/stables-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stables/stables-api/revisions/40ed0bdb89e1/schema)