List fit groups

GET

/v1/fit_groups

curl --request GET \
  --url 'https://api.tryyoursize.com/v1/fit_groups?limit=20' \
  --header 'Authorization: Bearer <token>'

• Production (test and live mode are chosen by the key)

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

Cursor-paginated.

Authorizations

• SecretKey

Parameters

Query Parameters

limit

integer

default: 20 >= 1 <= 100

Page size (list convention). Default 20, at most 100.

cursor

string

<= 512 characters

Opaque cursor from the previous page’s next_cursor (list convention). Omit it for the first page.

Responses

200

OK

Media typeapplication/json

One page of a list (convention). Pass next_cursor as cursor for the next page while has_more is true.

object

data

required

Array<object>

One garment (fit block + fabric) shared by many products: colourways, prints, reorders. Stored in the garments table; its versions are the garment versions.

object

id

required

string format: uuid

name

required

string

product_ids

required

Array<string>

published_version_id

string format: uuid

draft_version_id

string format: uuid

created_at

required

string format: date-time

updated_at

required

string format: date-time

has_more

required

boolean

next_cursor

string

nullable

Example ^generated

{
  "data": [
    {
      "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "name": "example",
      "product_ids": [
        "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
      ],
      "published_version_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "draft_version_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "created_at": "2026-04-15T12:00:00Z",
      "updated_at": "2026-04-15T12:00:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "example"
}

400

Invalid request

Media typeapplication/json

Every error has this shape. error is a human-readable message, status the HTTP status. code is stable and machine-readable; doc_url links its explanation; request_id identifies the request (also in the X-Request-ID response header): quote it to support.

object

error

required

string

status

required

integer

code

Stable error code, e.g. invalid_request, unauthorized, reauth_required, payment_required, forbidden, not_found, conflict, unprocessable, rate_limited, internal_error, not_implemented, unavailable, invalid_api_version, idempotency_key_in_use, idempotency_key_reused, invalid_idempotency_key, handle_expired, handle_invalid.

string

doc_url

string format: uri

request_id

string

Example

{
  "code": "not_found",
  "doc_url": "https://docs.tryyoursize.com/api/errors/#not_found"
}

401

Missing or invalid credentials

Media typeapplication/json

Every error has this shape. error is a human-readable message, status the HTTP status. code is stable and machine-readable; doc_url links its explanation; request_id identifies the request (also in the X-Request-ID response header): quote it to support.

object

error

required

string

status

required

integer

code

Stable error code, e.g. invalid_request, unauthorized, reauth_required, payment_required, forbidden, not_found, conflict, unprocessable, rate_limited, internal_error, not_implemented, unavailable, invalid_api_version, idempotency_key_in_use, idempotency_key_reused, invalid_idempotency_key, handle_expired, handle_invalid.

string

doc_url

string format: uri

request_id

string

Example

{
  "code": "not_found",
  "doc_url": "https://docs.tryyoursize.com/api/errors/#not_found"
}

403

Not allowed

Media typeapplication/json

Every error has this shape. error is a human-readable message, status the HTTP status. code is stable and machine-readable; doc_url links its explanation; request_id identifies the request (also in the X-Request-ID response header): quote it to support.

object

error

required

string

status

required

integer

code

Stable error code, e.g. invalid_request, unauthorized, reauth_required, payment_required, forbidden, not_found, conflict, unprocessable, rate_limited, internal_error, not_implemented, unavailable, invalid_api_version, idempotency_key_in_use, idempotency_key_reused, invalid_idempotency_key, handle_expired, handle_invalid.

string

doc_url

string format: uri

request_id

string

Example

{
  "code": "not_found",
  "doc_url": "https://docs.tryyoursize.com/api/errors/#not_found"
}