> ## Documentation Index
> Fetch the complete documentation index at: https://developer.clopos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Customer Groups

> Retrieve a list of all customer groups with pagination support.

This endpoint retrieves a list of all customer groups.

<ResponseExample>
  ```json Response theme={null}
  {
      "success": true,
      "data": [
          {
              "id": 1,
              "name": "My Customers",
              "discount_type": null,
              "discount_value": 0,
              "system_type": "my_customers",
              "created_at": "2025-08-16T15:21:15.000000Z",
              "updated_at": "2025-08-16T15:21:15.000000Z",
              "deleted_at": null
          }
      ],
      "total": 1,
      "time": 71,
      "timestamp": "2025-10-24 05:38:15",
      "sorts": [
          "id",
          "name",
          "discount_type",
          "discount_value",
          "total_amount",
          "created_at",
          "updated_at",
          "deleted_at"
      ],
      "unix": 1761284295
  }
  ```
</ResponseExample>

### Customer Group Object

| Field            | Type           | Description                                           |
| ---------------- | -------------- | ----------------------------------------------------- |
| `id`             | integer        | The unique identifier for the customer group.         |
| `name`           | string         | The name of the customer group.                       |
| `discount_type`  | string \| null | The type of discount associated with the group.       |
| `discount_value` | number         | The value of the discount.                            |
| `system_type`    | string \| null | The system type of the group (e.g., 'my\_customers'). |
| `created_at`     | string         | The timestamp when the group was created.             |