# List fit groups

```http
GET /v1/fit_groups
```

Source: https://docs.tryyoursize.com/api/reference/operations/listcatalogfitgroups/

**Key scopes:** `products:read`. A secret key (`sk_`) has every scope; a restricted key (`rk_`) needs the scopes listed.

Cursor-paginated.

## Authentication

Secret key (`sk_…`) or restricted key (`rk_…`) from your server: `Authorization: Bearer sk_…`.

## Parameters

- `limit` (query, `integer`, optional): Page size (list convention). Default 20, at most 100.
- `cursor` (query, `string`, optional): Opaque cursor from the previous page's `next_cursor` (list convention). Omit it for the first page.

## Responses

### 200

OK (`FitGroupPage`)

- `data` (`FitGroup[]`, required)
  - `id` (`string (uuid)`, required)
  - `name` (`string`, required)
  - `product_ids` (`string (uuid)[]`, required)
  - `published_version_id` (`string (uuid)`, optional)
  - `draft_version_id` (`string (uuid)`, optional)
  - `created_at` (`string (date-time)`, required)
  - `updated_at` (`string (date-time)`, required)
- `has_more` (`boolean`, required)
- `next_cursor` (`string`, optional)

### 400

Invalid request (`Error`)

### 401

Missing or invalid credentials (`Error`)

### 403

Not allowed (`Error`)

## Example

```bash
curl -X GET https://api.tryyoursize.com/v1/fit_groups \
  -H "Authorization: Bearer $TRYYOURSIZE_SECRET_KEY" \
  -H "TYS-Version: 2026-10-25"
```

## In the SDKs

- Node.js: [`tys.fitGroups.list()`](https://docs.tryyoursize.com/reference/node/fit-groups-list.md)
- Python: [`tys.fit_groups.list()`](https://docs.tryyoursize.com/reference/python/fit-groups-list.md)