# clth.fyi for developers

A unique QR for every piece of clothing. This page is the Markdown twin of /developers.

- OpenAPI: /openapi.json
- Public item: GET /api/v1/items/{code}
- Provenance: GET /api/v1/items/{code}/provenance
- Designs: GET /api/v1/designs
- MCP: POST /mcp (Streamable HTTP)

Public reads send CORS headers, JSON errors, and `source_url` plus `updated_at` on every record.
Rate limits answer with HTTP 429 and a Retry-After header.

MCP tools, all annotated readOnlyHint: get_item, verify_ownership, get_provenance, list_designs.
Owner emails are never returned.

Maker routes use `Authorization: Bearer clth_...`.

Mint before details: POST /api/v1/batches without design_id (pass garment_type), then PATCH /api/v1/designs/:id. Scans show "details coming soon" until then.

Printable labels: /label/{code}.svg?style=full (default) | facts-blank | qr. Batch items carry label_urls for all three.
