---
title: "Get a customer by ID"
method: GET
path: "/v2/customer/{id}"
---

# Get a customer by ID

`GET /v2/customer/{id}`

Get information about a customer by their ID

## Path parameters

- `id` string, required

## Response `200`

- union
  - object — Response containing information about an individual customer.
    - `id` string, required — Customer ID
    - `email` string — Customer email address
    - `phone` string — Customer phone number
    - `verificationProfiles` object[], required — Array of verification profiles. For individual customers, this will include kyc_profile_a. For business customers, this will include kyb_profile_a. See [KYC Flow](/concepts/onboarding/individual-kyc) for individuals or [KYB Flow](/concepts/onboarding/business-kyb) for businesses. See [Verification Profile](/concepts/onboarding/verification-profile) for individual status definitions and criteria breakdown or [Verification Profile](/concepts/onboarding/verification-profile) for business status definitions and criteria breakdown.
      - `name` 'kyc_profile_a' | 'kyb_profile_a' | 'ubo_kyc_profile_a' | 'kyc_profile_b' | 'kyb_profile_b' | 'kyb_profile_c' | 'kyc_profile_c' | 'ubo_kyc_profile_c', required — The name of the verification profile.
      - `status` 'incomplete' | 'pending' | 'approved' | 'rejected' | 'resubmission_required', required — The status of the verification profile.
      - `criteria` object — The criteria for the verification profile.
        - `complete` string[], required — Completed fields.
        - `pending` string[], required — Pending fields. These fields are currently being verified.
        - `required` string[], required — Required fields. These fields are required to be completed before the verification profile can be approved.
        - `errors` object[], required — The errors that occurred while verifying the fields.
          - `name` 'email_verification' | 'phone_verification' | 'residential_address' | 'identity_document' | 'tax_identification_number' | 'liveness_check' | 'terms_of_service' | 'email_address' | 'phone_number' | 'master_service_agreement' | 'legal_name' | 'trade_name' | 'entity_type' | 'entity_type_description' | 'description' | 'registered_address' | 'operating_address' | 'business_representatives' | 'naics_code' | 'website' | 'incorporated_on' | 'identification_number' | 'registration_number' | 'estimated_annual_revenue' | 'expected_monthly_payments' | 'account_purpose' | 'account_purpose_description' | 'source_of_funds' | 'source_of_funds_description' | 'is_dao' | 'regulated_activities' | 'regulated_activities_description' | 'participates_in_regulated_financial_activity' | 'regulated_financial_activity_description' | 'money_services_description' | 'compliance_screening_explanation' | 'operates_in_prohibited_countries' | 'incorporation_cert_document' | 'incorporation_articles_document' | 'shareholder_registry_document' | 'proof_of_nature_of_business_document' | 'proof_of_address_document' | 'liveness_report_document' | 'ownership_percentage' | 'is_control_person' | 'is_signer' | 'relationship_established_at' | 'title' | 'sex' | 'country_of_birth' | 'nationality' | 'middle_name' | 'occupation_soc_code' | 'w8_ben_document' | 'w9_document' | 'w8_ben_e_document' | 'corporate_resolution_document' | 'source_of_funds_document' | 'financial_statements_document' | 'bank_statement_document' | 'regulated_activity_document' | 'flow_of_funds_document' | 'kyc_b_approval' | 'kyb_b_approval', required
          - `detail` string
    - `meta` object
    - `tosStatus` 'incomplete' | 'pending' | 'approved', required — Customer Terms of Service acceptance status (incomplete | pending | approved).
    - `createdAt` string, required — ISO 8601 formatted customer creation timestamp
    - `updatedAt` string, required — ISO 8601 formatted customer update timestamp
    - `type` 'individual', required — Customer type
    - `firstName` string — Customer first name (individual customers only)
    - `lastName` string — Customer last name (individual customers only)
    - `dateOfBirth` string — The customer's date of birth in YYYY-MM-DD format (individual customers only).
    - `personalInformation` object — Personal information for an individual customer, echoed back from the most recent submission. The tax identification number is omitted from responses for privacy.
      - `taxIdentificationNumberType` string — The type of tax identification number of the customer. Required when providing tax identification information. Please refer to the [Individual Verification Criteria](/concepts/onboarding/verification-profile) for the full list of reference.
      - `taxIdentificationNumberCountry` string — The ISO3166-1 Alpha-3 country code for the tax identification number. Required when providing tax identification information. See [Country Codes](/concepts/reference/supported-countries).
      - `taxIdentificationNumberDescription` string — Description of the tax identification number. Required when type is `other`
      - `accountPurpose` 'personal_or_living_expenses' | 'payments_to_friends_or_family_abroad' | 'receive_salary' | 'receive_payment_for_freelancing' | 'protect_wealth' | 'purchase_goods_and_services' | 'charitable_donations' | 'ecommerce_retail_payments' | 'investment_purposes' | 'operating_a_company' — The purpose of the account. Required for EEA-resident individuals.
      - `gender` 'male' | 'female' | 'other' — The gender of the customer. Required by some verification providers.
      - `countryOfBirth` string — The ISO3166-1 Alpha-3 country code of the country where the customer was born. See [Country Codes](/concepts/reference/supported-countries).
      - `nationality` string — The ISO3166-1 Alpha-3 country code of the customer's nationality. Required by some verification providers. See [Country Codes](/concepts/reference/supported-countries).
      - `middleName` string — The customer's middle name. Required for some verification flows.
      - `occupationSocCode` string — The customer's occupation as a 6-digit Standard Occupational Classification (SOC) code, validated against the supported occupation list. Required for some verification flows.
      - `residencyCountry` string — The ISO3166-1 Alpha-3 country code of the customer's country of residency. Often satisfied by the address country, but some verification providers require it as a separate attribute. See [Country Codes](/concepts/reference/supported-countries).
      - `sourceOfFunds` 'salary' | 'business_income' | 'investment_returns' | 'inheritance' | 'gift' | 'savings' | 'other' — The customer's primary source of funds. Required by some verification providers.
  - object — Response containing information about a business customer.
    - `id` string, required — Customer ID
    - `email` string — Customer email address
    - `phone` string — Customer phone number
    - `verificationProfiles` object[], required — Array of verification profiles. For individual customers, this will include kyc_profile_a. For business customers, this will include kyb_profile_a. See [KYC Flow](/concepts/onboarding/individual-kyc) for individuals or [KYB Flow](/concepts/onboarding/business-kyb) for businesses. See [Verification Profile](/concepts/onboarding/verification-profile) for individual status definitions and criteria breakdown or [Verification Profile](/concepts/onboarding/verification-profile) for business status definitions and criteria breakdown.
      - `name` 'kyc_profile_a' | 'kyb_profile_a' | 'ubo_kyc_profile_a' | 'kyc_profile_b' | 'kyb_profile_b' | 'kyb_profile_c' | 'kyc_profile_c' | 'ubo_kyc_profile_c', required — The name of the verification profile.
      - `status` 'incomplete' | 'pending' | 'approved' | 'rejected' | 'resubmission_required', required — The status of the verification profile.
      - `criteria` object — The criteria for the verification profile.
        - `complete` string[], required — Completed fields.
        - `pending` string[], required — Pending fields. These fields are currently being verified.
        - `required` string[], required — Required fields. These fields are required to be completed before the verification profile can be approved.
        - `errors` object[], required — The errors that occurred while verifying the fields.
          - `name` 'email_verification' | 'phone_verification' | 'residential_address' | 'identity_document' | 'tax_identification_number' | 'liveness_check' | 'terms_of_service' | 'email_address' | 'phone_number' | 'master_service_agreement' | 'legal_name' | 'trade_name' | 'entity_type' | 'entity_type_description' | 'description' | 'registered_address' | 'operating_address' | 'business_representatives' | 'naics_code' | 'website' | 'incorporated_on' | 'identification_number' | 'registration_number' | 'estimated_annual_revenue' | 'expected_monthly_payments' | 'account_purpose' | 'account_purpose_description' | 'source_of_funds' | 'source_of_funds_description' | 'is_dao' | 'regulated_activities' | 'regulated_activities_description' | 'participates_in_regulated_financial_activity' | 'regulated_financial_activity_description' | 'money_services_description' | 'compliance_screening_explanation' | 'operates_in_prohibited_countries' | 'incorporation_cert_document' | 'incorporation_articles_document' | 'shareholder_registry_document' | 'proof_of_nature_of_business_document' | 'proof_of_address_document' | 'liveness_report_document' | 'ownership_percentage' | 'is_control_person' | 'is_signer' | 'relationship_established_at' | 'title' | 'sex' | 'country_of_birth' | 'nationality' | 'middle_name' | 'occupation_soc_code' | 'w8_ben_document' | 'w9_document' | 'w8_ben_e_document' | 'corporate_resolution_document' | 'source_of_funds_document' | 'financial_statements_document' | 'bank_statement_document' | 'regulated_activity_document' | 'flow_of_funds_document' | 'kyc_b_approval' | 'kyb_b_approval', required
          - `detail` string
    - `meta` object
    - `tosStatus` 'incomplete' | 'pending' | 'approved', required — Customer Terms of Service acceptance status (incomplete | pending | approved).
    - `createdAt` string, required — ISO 8601 formatted customer creation timestamp
    - `updatedAt` string, required — ISO 8601 formatted customer update timestamp
    - `type` 'business', required — Customer type
    - `businessLegalName` string — Customer business legal name (business customers only)
    - `businessTradeName` string — Customer business trade name (business customers only)

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `422` — Unprocessable Entity - Validation Error

---

[API](https://skmtc.net/spherepay/apis/docs-spherepay-co.md) · [All operations](https://skmtc.net/spherepay/apis/docs-spherepay-co/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spherepay/docs-spherepay-co/versions/4f3f5484aed3/schema)