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

# GET /customers

`GET /customers`

Retrieve all customers

## Query parameters

- `email` string
- `created_at_min` string, date-time
- `created_at_max` string, date-time
- `offset` integer
- `limit` integer
- `dir` 'next' | 'prev'

## Response `200`

Successful operation. Response will return an array of 0 or more customers

- object
  - `data` CustomerService[]
    - `id` integer — The SamCart ID of the customer
    - `first_name` string, nullable — The first name of the customer
    - `last_name` string, nullable — The last name of the customer
    - `email` string, email — The email address of the customer
    - `phone` string, nullable — The phone number of the customer
    - `customer_tags` object[] — The tags applied to the customer
      - `name` string — The name of the customer tag
    - `lifetime_value` integer — The lifetime value (in cents) of the customer. Value is for live data only
    - `updated_at` string, date-time — The UTC date and time when the customer information was updated
    - `created_at` string, date-time — The UTC date and time when the customer was created
    - `addresses` AddressService[] — Addresses associated with the customer
      - `type` 'shipping' | 'billing' — The type of address for the customer
      - `street` string — The street for the customer
      - `postal_code` string — The postal code for the customer
      - `city` string — The city name for the customer
      - `state` string, nullable — The 2-letter state code for US customers. For non-US addresses this value will be null.
      - `region` string, nullable — The optional sub-divided area of a country for international customers. For US addresses this value will be null.
      - `country` string — The country for the customer
  - `pagination` Pagination — Optional information for paginating large data sets.
    - `next` string, uri, nullable — A URL to the next page of data to be retrieve. If current page is the last page this value will be null.
    - `prev` string, uri, nullable — A URL to the previous page of data to be retrieve. If current page is the first page this value will be null.

---

[API](https://skmtc.dev/samcart/apis/samcart-public-api.md) · [All operations](https://skmtc.dev/samcart/apis/samcart-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/samcart/samcart-public-api/revisions/80296f7a00d0/schema)