---
title: "Search for customers"
method: GET
path: "/shop/customers/search"
tags: ["Customers"]
---

# Search for customers

`GET /shop/customers/search`

Use this endpoint to search for customers.

## Response `200`

Contains the customer stats.

- object
  - `data` CustomerSearchResult[], required — The list of customers matching the search criteria.
    - `id` string, required — The unique identifier for the customer.
    - `first_name` string, required — The first name of the customer.
    - `last_name` string, required — The last name of the customer.
    - `email` string, email, required — The email address of the customer.
    - `sources` string[], required — The sources where the customer was found.
    - `labels` CustomerLabel[], required — The Trybe labels associated with the customer.
      - `id` string, uuid, required — The unique identifier for the label.
      - `name` string, required — The name of the label.
      - `color` string, required — The color associated with the label.
  - `meta` CustomerSearchMeta, required
    - `sources` CustomerSearchResultsSource[], required — An array of sources that were queried during the search.
      - `key` string, required — The source of the customers.
      - `name` string, required — The name of the source.
      - `status` string, required — The status of attempt to search for customers from this source.
      - `message` string, nullable — An optional message about the source.

## Other responses

- `401` — The user is unauthenticated
- `422` — The request didn't pass validation

---

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