---
title: "Get customer"
method: GET
path: "/v1beta/customers/{handle}"
tags: ["Customer"]
---

# Get customer

`GET /v1beta/customers/{handle}`

## Path parameters

- `handle` string, required

## Query parameters

- `with_additional_data` boolean

## Response `200`

A successful response.

- CustomerGetCustomerResponse
  - `code` integer
  - `data` CustomerGetCustomerResponseData
    - `additional_data` CustomerCustomerAdditionalData
      - `attached_files` CustomerFile[]
        - `description` string
        - `doc_type` string
        - `path` string
      - `birth_address` string
      - `birth_city` string
      - `birth_country` string
      - `birth_date` string
      - `birth_state` string
      - `birth_zipcode` string
      - `company_registration_city` string
      - `company_registration_number` string
      - `company_registration_subscription_date` string
      - `company_url` string
      - `headquarters_address` string
      - `headquarters_city` string
      - `headquarters_country` string
      - `headquarters_state` string
      - `headquarters_zipcode` string
      - `passport_number` string
      - `social_security_number` string
      - `trading_name` string
    - `address` ContactAddress
      - `city` string
      - `country` string
      - `number` string
      - `state` string
      - `street` string
      - `suffix` string
      - `zipcode` string
    - `comments` string
    - `comments_last_changed_at` string
    - `company_name` string
    - `deleted_at` string
    - `email` string
    - `email_verification_status` string
    - `extension_additional_data` CustomerExtensionAdditionalData[]
      - `data` CustomerExtensionData
        - `admin_type` string
        - `applicant_purpose` string
        - `birth_date` string
        - `company_name_cyrillic` string
        - `company_name_latin` string
        - `company_registration_number` string
        - `contact_title` string
        - `country_of_citizenship` string
        - `customer_uin` string
        - `ens_auth_id` string
        - `ens_key` string
        - `first_name_cyrillic` string
        - `first_name_latin` string
        - `hr_member` string
        - `in_nexus_connection_to_india` string
        - `in_nexus_declaration_attestation` string
        - `industry_class` string
        - `is_private_enterpreneur` string
        - `last_name_cyrillic` string
        - `last_name_latin` string
        - `legal_address_area` string
        - `legal_address_building` string
        - `legal_address_city` string
        - `legal_address_country_code` string
        - `legal_address_cyrillic` string
        - `legal_address_house` string
        - `legal_address_postal_code` string
        - `legal_address_region` string
        - `legal_address_street` string
        - `legal_type` string
        - `middle_name_cyrillic` string
        - `middle_name_latin` string
        - `mobile_phone_number` string
        - `mobile_phone_number_country_code` string
        - `music_nexus_connection_to_music` string
        - `music_nexus_registry_policies_attestation` string
        - `nexus_category` string
        - `org_type` string
        - `passport_expiry_date` string
        - `passport_issue_date` string
        - `passport_issue_id` string
        - `passport_issuer` string
        - `passport_number` string
        - `passport_series` string
        - `postal_address_area` string
        - `postal_address_building` string
        - `postal_address_city` string
        - `postal_address_cyrillic` string
        - `postal_address_house` string
        - `postal_address_region` string
        - `postal_address_street` string
        - `social_security_number` string
        - `sole_proprietorship` string
        - `tax_payer_number` string
        - `uin` string
        - `user_type` string
        - `vat` string
        - `website` string
        - `whois_email` string
      - `name` string
    - `fax` CustomerFax
      - `area_code` string
      - `country_code` string
      - `subscriber_number` string
    - `handle` string
    - `id` integer
    - `inn` string
    - `is_deleted` boolean
    - `locale` string
    - `name` ContactName
      - `first_name` string
      - `full_name` string
      - `initials` string
      - `last_name` string
      - `prefix` string
    - `phone` ContactPhone
      - `area_code` string
      - `country_code` string
      - `subscriber_number` string
    - `reseller_id` integer
    - `tags` CustomerTags[]
      - `key` string
      - `value` string
    - `vat` string
  - `desc` string
  - `maintenance` boolean
  - `warnings` ErrorWarning[]
    - `code` integer
    - `data` string
    - `desc` string

## Other responses

- `default` — (empty)

---

[API](https://skmtc.dev/openprovider/apis/rest-api.md) · [All operations](https://skmtc.dev/openprovider/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openprovider/rest-api/revisions/a57b11984574/schema)