---
title: "Get a list of customers"
method: GET
path: "/v2/customers"
tags: ["Customers"]
---

# Get a list of customers

`GET /v2/customers`

This endpoint returns a list of customers that match the specified search criteria.

The response includes partial information for each customer, including essential fields from the customer profile, risk level, and status objects.

Complete details for each customer can be retrieved by calling the relevant endpoint with a specific customer identifier.

This endpoint can return up to 10,000 customers. For larger datasets, use the 'exports' endpoint, which is designed for exporting large volumes of data.


You need the "View customers" permission to use this endpoint.

## Query parameters

- `search` string
- `created_at_from` string, date-time
- `created_at_to` string, date-time
- `updated_at_from` string, date-time
- `updated_at_to` string, date-time
- `type` string
- `risk_level` string
- `status` string
- `monitoring_enabled` boolean
- `acquisition_source` string[]
- `segments` string[]
- `labels` string[]
- `sort` string
- `industry_code` string[]
- `industry_code_description` string[]
- `page_number` integer
- `page_size` integer

## Response `200`

Get the list of customers

- CustomerManagerCustomersList
  - `customers` CustomerManagerCustomerForSearch[], required
    - `acquisition_source` string, nullable
    - `company` CustomerManagerCompanyForSearch
      - `industry_codes` CustomerManagerIndustryCodeForSearch[], nullable
        - `code` string, required
        - `description` string, nullable
      - `legal_name` string, required
    - `created_at` string, date-time, nullable
    - `customer_identifier` string, uuid, required
    - `external_identifier` string, nullable
    - `monitor` CustomerManagerMonitorStatus
      - `entity_screening` CustomerManagerEntityScreeningStatus, required
        - `enabled` boolean, nullable
    - `person` CustomerManagerPersonForSearch
      - `fathers_name` string, nullable
      - `first_name` string, nullable
      - `full_name` string, nullable
      - `last_name` string, nullable
      - `middle_name` string, nullable
      - `mothers_name` string, nullable
      - `suffix` string, nullable
    - `scores` CustomerManagerRiskScore
      - `overall_result` CustomerManagerRiskScoreResult, required
        - `level` 'UNSPECIFIED' | 'SKIPPED' | 'UNKNOWN' | 'LOW' | 'MEDIUM' | 'HIGH' | 'PROHIBITED', nullable
    - `status` 'ACTIVE' | 'CLOSED' | 'PROCESSING', nullable
    - `undefined_customer_type` CustomerManagerUndefinedForSearch
      - `name` string, required
    - `updated_at` string, date-time, nullable
  - `page_number` integer, required
  - `page_size` integer, required
  - `total_count` integer, required

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found

---

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