# API changelog

> Dated versions of the TryYourSize server API (TYS-Version header), newest first.

Source: https://docs.tryyoursize.com/api/changelog/

Pin a version with the `TYS-Version` header. Latest version: `2026-10-25`.

## 2026-10-25

Released 2026-10-25. First dated version of the server API.

- **Added:** POST /v1/recommendations: the shopper's size for your server or headless storefront, from a handle the browser SDK issues (tys.recommendationHandle()).
- **Added:** Catalog API with secret and restricted keys: /v1/products, /v1/products/{product}/size_map, /v1/products/{product}/garments, /v1/garments/{garment_id}(/publish), /v1/fit_groups.
- **Added:** Idempotency-Key on POST requests made with secret and restricted keys (responses stored for 24 hours).
- **Added:** Errors carry code, doc_url and request_id; every response carries X-Request-ID and TYS-Version.
- **Added:** Cursor pagination for lists: limit, cursor → data, has_more, next_cursor.
- **Note:** Orders and returns (POST /v1/orders, /v1/returns) and webhooks (envelope api_version "2026-10") are part of this version.