---
title: "Get customers"
method: GET
path: "/consumers/{consumer_id}/pos/customers"
tags: ["Point of Sale", "customers", "Customers"]
---

# Get customers

`GET /consumers/{consumer_id}/pos/customers`

Returns the list of customers

## Path parameters

- `consumer_id` string, uuid, required

## Query parameters

- `page` integer
- `size` integer
- `search` string, nullable
- `email` string, nullable
- `phone` string, nullable

## Response `200`

Successful Response

- ChiftPagePOSCustomerItem
  - `items` POSCustomerItem[], required
    - `id` string, required — Unique identifier of the customer
    - `first_name` string, nullable — First name of the customer
    - `last_name` string, nullable — Last name of the customer
    - `name` string, required — Name (first name + last name) of the customer
    - `phone` string, nullable — Phone number (mobile, home, work, ...) of the customer
    - `email` string, nullable — Email address of the customer
    - `created_on` string, date-time, nullable — Date and time when the customer was created
    - `addresses` AddressItem[], nullable — List of addresses of the customer
      - `address_type` string, nullable — Type of the address
      - `name` string, nullable — Name given to the address (e.g. 'home')
      - `street` string, nullable — Street name
      - `number` string, nullable — Number of the address
      - `box` string, nullable — Box of the address
      - `city` string, nullable — City name
      - `postal_code` string, nullable — Postal code of the address
      - `country` string, nullable — Country, format: ISO 3166-1 codes.
    - `loyalty` integer, nullable — Loyalty points of the customer
    - `birthdate` string, date, nullable — Birthdate of the customer
  - `total` integer, required
  - `page` integer, required
  - `size` integer, required

## Other responses

- `400` — Bad Request
- `405` — Method Not Allowed
- `422` — Validation Error
- `502` — Bad Gateway

---

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