---
title: "Get customers by email"
method: GET
path: "/v1/customers"
tags: ["Customers"]
---

# Get customers by email

`GET /v1/customers`

Return a list of people in your workspace matching an email address.

If the email contains special characters like `+`, make sure you [percent-encode](/integrations/api/customerio-apis/#url-encoding) them in the query parameter. For example, use `jane%2Bnotifications%40example.com` instead of `jane+notifications@example.com`. Unencoded special characters can return empty results without an error.

## Query parameters

- `email` string, email, required

## Response `200`

Returns an array of `results`; each result represents a person.

- object
  - `results` object[] — A list of customers matching the email address in your query.
    - `email` string, email, nullable, required — A person's email address, if set.
    - `id` string, nullable, required — A person's unique ID, if set.
    - `cio_id` string, required — A unique identifier set by Customer.io, used to reference a person if you want to update their identifiers.

## Other responses

- `401` — Unauthorized request. Make sure that you provided the right credentials.
- `429` — Your request is over the 10-per-second limit.

---

[API](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference.md) · [All operations](https://skmtc.dev/customer/apis/customer-io-journeys-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/customer/customer-io-journeys-api-reference/revisions/4b391af7cb06/schema)