---
title: "List customers"
method: GET
path: "/v1beta/customers"
tags: ["Customer"]
---

# List customers

`GET /v1beta/customers`

## Query parameters

- `reseller_id` integer
- `limit` integer
- `offset` integer
- `order` string
- `order_by` string
- `email_pattern` string
- `company_name_pattern` string
- `last_name_pattern` string
- `first_name_pattern` string
- `comment_pattern` string
- `handle_pattern` string
- `pattern` string
- `with_additional_data` boolean
- `type` string
- `columns` string[]

## Response `200`

A successful response.

- CustomerListCustomersResponse
  - `code` integer
  - `data` CustomerListCustomersResponseData
    - `results` CustomerListCustomersResponseDataResults[]
      - `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
          - `industry_class` string
          - `is_private_enterpreneur` string
          - `last_name_cyrillic` string
          - `last_name_latin` string
          - `legal_address_cyrillic` string
          - `legal_type` string
          - `middle_name_cyrillic` string
          - `middle_name_latin` string
          - `mobile_phone_number` string
          - `nexus_category` string
          - `org_type` string
          - `passport_issue_date` string
          - `passport_issuer` string
          - `passport_number` string
          - `passport_series` string
          - `postal_address_cyrillic` string
          - `social_security_number` string
          - `tax_payer_number` string
          - `uin` string
          - `user_type` string
          - `vat` string
          - `website` string
          - `whois_email` string
        - `name` string
      - `handle` string
      - `id` integer
      - `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
    - `total` integer
  - `desc` string
  - `maintenance` boolean
  - `warnings` ErrorWarning[]
    - `code` integer
    - `data` string
    - `desc` string

## Other responses

- `default` — (empty)

---

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