---
title: "Get customer by email"
method: GET
path: "/stores/{storeId}/customers"
tags: ["Customers"]
---

# Get customer by email

`GET /stores/{storeId}/customers`

Retrieve a customer profile by email address.

The response includes the customer's name, contact information, location,
and any custom fields associated with the profile. Custom fields are returned
as `{ fieldName: value }` pairs.

Requires the [`customers_read`](/docs/api-reference/scopes) scope.

## Path parameters

- `storeId` string, required

## Query parameters

- `email` string, email, required

## Response `200`

Customer found

- CustomerReadSchema — Customer profile.
  - `id` string, required — Redo customer ID
  - `email` string, email, required — Customer email address
  - `firstName` string — Customer first name
  - `lastName` string — Customer last name
  - `phoneNumber` string — Customer phone number in E.164 format
  - `location` CustomerLocationSchema — Customer location information.
    - `street1` string — Street address line 1
    - `street2` string — Street address line 2
    - `city` string — City name
    - `state` string — State or province name
    - `stateCode` string — State or province abbreviation
    - `postalCode` string — Postal or ZIP code
    - `country` string — Country name
    - `countryCode` string — ISO 3166-1 alpha-2 country code
    - `ianaTimeZoneName` string — IANA time zone identifier
    - `latitude` number — Latitude coordinate
    - `longitude` number — Longitude coordinate
  - `customFields` object — Custom field values as key-value pairs, where keys are field names and values can be strings, numbers, or booleans. DATE custom field values are returned as ISO 8601 datetime strings (e.g., "2026-01-15T12:00:00.000Z"), not Date objects.
  - `createdAt` string, date-time, nullable — Timestamp when the customer was created. May be null for older customers created before this field was tracked.
  - `updatedAt` string, date-time, nullable — Timestamp when the customer was last updated. May be null for older customers created before this field was tracked.

## Other responses

- `400` — Missing or invalid email parameter
- `404` — No customer found for that email
- `500` — Internal server error
- `default` — Error

---

[API](https://skmtc.net/redoapp/apis/redo-api.md) · [All operations](https://skmtc.net/redoapp/apis/redo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/redoapp/redo-api/versions/119714540a45/schema)