---
title: "Get customers for customer group"
method: GET
path: "/customer_groups/{customer_group_id}/customers"
tags: ["Customer Groups"]
---

# Get customers for customer group

`GET /customer_groups/{customer_group_id}/customers`

Returns a list of customers for the given Customer Group

🔒 Requires: `customers:read` scope

## Path parameters

- `customer_group_id` string, required

## Query parameters

- `after` integer
- `before` integer
- `page_size` integer

## Response `200`

OK

- CustomerCollection
  - `data` Customer[] — An array of Customer objects.
    - `balance` number, double — Customer's unpaid balance.
    - `company_name` string, nullable — Company name.
    - `created_at` string — Creation timestamp in UTC.
    - `custom_field_1` string, nullable — Custom field 1. Can be used to store random data.
    - `custom_field_2` string, nullable — Custom field 2.
    - `custom_field_3` string, nullable — Custom field 3.
    - `custom_field_4` string, nullable — Custom field 4.
    - `customer_code` string — Customer code used for claiming loyalty.
    - `customer_group_id` string — Customer group ID.
    - `date_of_birth` string, nullable — Birthday.
    - `deleted_at` string, nullable — Deletion timestamp in UTC.
    - `do_not_email` boolean — Indicates whether the customer opted out of email communications.
    - `email` string, nullable — Customer's email address.
    - `enable_loyalty` boolean
    - `enable_promotional_sms` boolean — Indicates whether the customer opted in to SMS communications.
    - `fax` string, nullable — Fax no.
    - `first_name` string, nullable, required — Customer's first name.
    - `gender` string, nullable — Customer's gender. Can be `M`, `F` or null.
    - `id` string — Auto-generated object ID.
    - `last_name` string, nullable, required — Customer 's last name.
    - `loyalty_balance` number, double — Customer's loyalty balance.
    - `mobile` string, nullable — Mobile phone no.
    - `name` string, nullable — Customers full name. **deprecated**
    - `note` string, nullable — Customer note.
    - `on_account_limit` number, double, nullable — Customer's OnAccount Limit.
    - `phone` string, nullable — Phone no.
    - `physical_address_1` string, nullable — Physical address, line 1.
    - `physical_address_2` string, nullable — Physical address, line 2.
    - `physical_city` string, nullable — Physical address, city.
    - `physical_country_id` string, nullable — Physical address, country code.
    - `physical_postcode` string, nullable — Physical address, post code.
    - `physical_state` string, nullable — Physical address, state.
    - `physical_suburb` string, nullable — Physical address, suburb.
    - `postal_address_1` string, nullable — Postal address, line 1.
    - `postal_address_2` string, nullable — Postal address, line 2.
    - `postal_city` string, nullable — Postal address, city.
    - `postal_country_id` string, nullable — Postal address, country code.
    - `postal_postcode` string, nullable — Postal address, post code.
    - `postal_state` string, nullable — Postal address, state.
    - `postal_suburb` string, nullable — Postal address, suburb.
    - `tax_id` string, nullable — Customer's tax ID.
    - `twitter` string, nullable — Twitter handle.
    - `updated_at` string — Last update timestamp in UTC.
    - `version` integer — Auto-incrementing object version number.
    - `website` string, nullable — Website URL.
    - `year_to_date` number, double — Customer's spending this year.
  - `version` Version — An object containing the highest and lowest version numbers for all items of the returned collection.
    - `max` integer, nullable, required — Highest version number of the payload, or `null` when the result set is empty.
    - `min` integer, nullable, required — Lowest version number of the payload, or `null` when the result set is empty.

---

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