---
title: "Get Customer Details"
method: GET
path: "/v1/customers/{customer_id}"
tags: ["Customers"]
---

# Get Customer Details

`GET /v1/customers/{customer_id}`

Retrieve detailed information for a specific customer

## Path parameters

- `customer_id` string, uuid, required

## Response `200`

Customer details retrieved successfully

- object
  - `data` union
    - IndividualCustomerDetail
      - `customer_id` string, uuid
      - `type` 'INDIVIDUAL'
      - `first_name` string
      - `last_name` string
      - `email` string, email
      - `phone` string
      - `country_of_residence` string
      - `verification_type` string
      - `customer_status` string
      - `tos_policies_url` string, uri
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `last_status_updated_at` string, date-time
      - `capabilities` object — On-ramp and off-ramp capabilities for the customer
        - `on_ramp` object[]
          - `currency` string
          - `status` boolean
          - `methods` string[]
          - `reason` object
            - `for_customer` string, nullable
            - `for_developer` string, nullable
        - `off_ramp` object[]
          - `currency` string
          - `status` boolean
          - `methods` string[]
          - `reason` object
            - `for_customer` string, nullable
            - `for_developer` string, nullable
      - `rejection_reason` object, nullable — Populated when customer_status is REJECTED. Null otherwise.
      - `request_for_information` object[] — List of open requests for additional information. Empty when none are outstanding.
    - BusinessCustomerDetail
      - `customer_id` string, uuid
      - `type` 'BUSINESS'
      - `business_name` string
      - `email` string, email
      - `phone` string
      - `country_of_incorporation` string
      - `verification_type` string
      - `customer_status` string
      - `tos_policies_url` string, uri
      - `associated_parties` object[]
        - `id` string, uuid
        - `type` string
        - `ownership_percent` number
        - `email` string, email
        - `verification` object
          - `status` string
          - `reason` object
            - `for_customer` string, nullable
            - `for_developer` string, nullable
          - `updated_at` string, date-time
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `last_status_updated_at` string, date-time
      - `capabilities` object — On-ramp and off-ramp capabilities for the customer
        - `on_ramp` object[]
          - `currency` string
          - `status` boolean
          - `methods` string[]
          - `reason` object
            - `for_customer` string, nullable
            - `for_developer` string, nullable
        - `off_ramp` object[]
          - `currency` string
          - `status` boolean
          - `methods` string[]
          - `reason` object
            - `for_customer` string, nullable
            - `for_developer` string, nullable
      - `rejection_reason` object, nullable — Populated when customer_status is REJECTED. Null otherwise.
      - `request_for_information` object[] — List of pending information requests. Empty when none are outstanding.

## Other responses

- `401` — Authentication failed due to invalid credentials
- `404` — Customer not found
- `422` — Failed due to a formatting error.

---

[API](https://skmtc.net/fin/apis/fin-com-api.md) · [All operations](https://skmtc.net/fin/apis/fin-com-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fin/fin-com-api/versions/6e69503ee7b8/schema)