---
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

---

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