---
title: "List Customers"
method: GET
path: "/ecommerce/customers"
tags: ["ecommerce/customers"]
---

# List Customers

`GET /ecommerce/customers`

## Query parameters

- `remote_data` boolean
- `limit` number
- `cursor` string

## Headers

- `x-connection-token` string, required

## Response `200`

- object
  - `prev_cursor` string, nullable, required
  - `next_cursor` string, nullable, required
  - `data` object[], required
    - `email` string, nullable — The email of the customer
    - `first_name` string, nullable — The first name of the customer
    - `last_name` string, nullable — The last name of the customer
    - `phone_number` string, nullable — The phone number of the customer
    - `addresses` Address[], nullable — The addresses of the customer
      - `street_1` string, nullable, required — The street
      - `street_2` string, nullable, required — More information about the street
      - `city` string, nullable, required — The city
      - `state` string, nullable, required — The state
      - `postal_code` string, nullable, required — The postal code
      - `country` string, nullable, required — The country
      - `address_type` string, nullable, required — The address type. Authorized values are either PERSONAL or WORK.
      - `owner_type` string, nullable, required — The owner type of the address
    - `field_mappings` object, nullable — The custom field mappings of the object between the remote 3rd party & Panora
    - `id` string, nullable — The UUID of the customer
    - `remote_id` string, nullable — The remote ID of the customer in the context of the 3rd Party
    - `remote_data` object, nullable — The remote data of the customer in the context of the 3rd Party
    - `created_at` string, nullable — The created date of the object
    - `modified_at` string, nullable — The modified date of the object

## Changes

- **2024-12-16** `37e33fd8b040` — 1 breaking
  - for the `query` request parameter `limit`, default value `50` was added
- **2024-12-14** `69df76288cd9` — 1 breaking
  - for the `query` request parameter `limit`, default value `50` was removed
- **2024-11-21** `47f47d53c24d` — 1 breaking
  - for the `query` request parameter `limit`, default value `50` was added
- **2024-11-16** `8c8c3916da22` — 1 breaking
  - for the `query` request parameter `limit`, default value `50` was removed
- **2024-09-05** `5ba5c769e2e1` — 1 breaking
  - for the `query` request parameter `limit`, default value `50` was added

[Full history](https://skmtc.dev/panoratech/apis/panora-api/changes/ecommerce/customers/get.md)

---

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