---
search:
  tags:
    - Customers
    - GET
seo:
  description: >-
    Returns customer groups (segments) for the shop. Reference for the GET
    /shops/{shop_id}/customer_groups endpoint in the Bolder API v2.
sidebar:
  label: List contact groups (legacy shop-nested)
  badge: GET
title: List contact groups (legacy shop-nested)
type: openapi-operation
---
Returns customer groups (segments) for the shop.

`GET /shops/{shop_id}/customer_groups`

**cURL**

```bash
curl -s -H "Authorization: Bearer $BOLDER_TOKEN" \
  "https://api.onbolder.com/v2/shops/1/customer_groups"
```

**Responses**

- `200` — Contact groups list

Response example, 200:

```json
{
  "_class": [
    "results",
    "contactGroups"
  ],
  "total_items": 2,
  "_embedded": {
    "items": [
      {
        "id": 1,
        "name": "VIP Customers",
        "customers_count": 42,
        "allow_local_pickup": true,
        "allow_shipping": true,
        "allow_signups": false
      }
    ]
  }
}
```