Skip to main content
GET
/
stores
/
{storeId}
/
customers
Get customer by email
curl --request GET \
  --url https://api.getredo.com/v2.2/stores/{storeId}/customers \
  --header 'Authorization: Bearer <token>'
{
  "id": "67bd4f1a2e3c8d001a5f9b12",
  "email": "jane@example.com",
  "firstName": "Jane",
  "lastName": "Smith",
  "phoneNumber": "+11234567890",
  "location": {
    "street1": "123 Main St",
    "street2": "Suite 12",
    "city": "Seattle",
    "state": "Washington",
    "stateCode": "WA",
    "postalCode": "98101",
    "country": "United States",
    "countryCode": "US",
    "latitude": 47.6062,
    "longitude": -122.3321
  },
  "customFields": {
    "pricing_plan": "com.example.yearly",
    "status": "Active",
    "subscription_source": "web",
    "loyalty_points": 1250,
    "vip_member": true
  },
  "createdAt": "2026-02-20T18:30:00.000Z",
  "updatedAt": "2026-02-24T12:15:00.000Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
storeId
string
required

Store ID

Example:

"64e5a8a1af49a89df37e4ee7"

Query Parameters

​
email
string<email>
required

Customer email address

Response

Customer found

Customer profile.

​
id
string
required

Redo customer ID

Example:

"67bd4f1a2e3c8d001a5f9b12"

​
email
string<email>
required

Customer email address

Example:

"jane@example.com"

​
createdAt
string<date-time>
required

Timestamp when the customer was created.

Example:

"2026-02-20T18:30:00.000Z"

​
updatedAt
string<date-time>
required

Timestamp when the customer was last updated.

Example:

"2026-02-24T12:15:00.000Z"

​
firstName
string

Customer first name

Example:

"Jane"

​
lastName
string

Customer last name

Example:

"Smith"

​
phoneNumber
string

Customer phone number in E.164 format

Example:

"+11234567890"

​
location
Customer Location · object

Customer location information.

​
customFields
object

Custom field values as key-value pairs, where keys are field names and values can be strings, numbers, or booleans.

Example:
{
  "subscription_source": "web",
  "status": "Active",
  "loyalty_points": 1250,
  "vip_member": true
}