> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sagepilot.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get customer

> Get a customer by exact ID, email, or phone.

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "88d44689-1ce7-4033-8256-655a7cd8f90b",
    "name": "Vikram Singh Chundawat",
    "email": "vikram@sagepilot.ai",
    "phone": "+918003213447",
    "custom_fields": "{\"country\": \"Rajasthan\", \"location\": \"Bhilwara\", \"popup_submitted\": true, \"campaign.country\": \"Rajasthan\", \"popup_source_url\": \"https://sagepilot-test-account.myshopify.com/\", \"campaign.location\": \"Bhilwara\", \"popup_submitted_at\": \"2025-10-29T10:24:04.225Z\"}",
    "created_at": "2025-02-18T19:49:12.573277+00:00",
    "instagram_id": null,
    "instagram_username": null,
    "channel_name": "New Playground Channel",
    "channel_kind": "playground"
  }
  ```
</ResponseExample>

Get a single customer by exact ID, email, or phone.

## Required access

| Authentication                                               | Scope            | Dataset grant |
| ------------------------------------------------------------ | ---------------- | ------------- |
| [API client v2](/api-reference/authentication/api-client-v2) | `customers:read` | `customers`   |

## Body

One of `customerId`, `email`, or `phone` is required.

<ParamField body="workspaceId" type="string">
  Optional workspace UUID. The authenticated workspace is used by default. Find the current workspace ID in **Settings > API Details > Channels**. See [Resource IDs](/api-reference/authentication/api-client-v2#resource-ids).
</ParamField>

<ParamField body="customerId" type="string">
  Customer UUID to look up. Open a customer in the Customer module and use the last UUID in the URL: `/dashboard/[workspace_id]/customers/[customer_id]`. See [Resource IDs](/api-reference/authentication/api-client-v2#resource-ids).
</ParamField>

<ParamField body="email" type="string">
  Customer email to look up.
</ParamField>

<ParamField body="phone" type="string">
  Customer phone number to look up.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Customer ID.
</ResponseField>

<ResponseField name="name" type="string">
  Customer name.
</ResponseField>

<ResponseField name="email" type="string">
  Customer email.
</ResponseField>

<ResponseField name="phone" type="string">
  Customer phone number.
</ResponseField>