---
title: "Retrieve Customers"
method: GET
path: "/ecommerce/customers/{id}"
tags: ["ecommerce/customers"]
---

# Retrieve Customers

`GET /ecommerce/customers/{id}`

Retrieve customers from any connected Ats software

## Path parameters

- `id` string, required

## Query parameters

- `remote_data` boolean

## Headers

- `x-connection-token` string, required

## Response `200`

- UnifiedEcommerceCustomerOutput
  - `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-08-27** `5ba5c769e2e1` — 2 info
  - removed the `PERSONAL` enum value from the `addresses/items/address_type` response property for the response status `200`
  - removed the `WORK` enum value from the `addresses/items/address_type` response property for the response status `200`
- **2024-08-07** `bcedd35abe69` — 11 breaking, 8 info
  - the response property `addresses` became nullable for the status `200`
  - the response property `created_at` became nullable for the status `200`
  - the response property `email` became nullable for the status `200`
  - the response property `field_mappings` became nullable for the status `200`
  - …15 more

[Change history](https://skmtc.dev/panoratech/apis/panora-api/changes/ecommerce/customers/:id/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)