Catalog API

Product, variant, price, and meter endpoints.

Catalog endpoints manage what can be sold.

Products

GET /api/products
POST /api/products
GET /api/products/{id}
PATCH /api/products/{id}
DELETE /api/products/{id}
POST /api/products/{id}/archive
POST /api/products/{id}/unarchive

Product lists accept status=active, status=archived, or status=all.

Variants

GET /api/products/{id}/variants
POST /api/products/{id}/variants
GET /api/variants/{variantId}
PUT /api/variants/{variantId}
DELETE /api/variants/{variantId}
GET /api/variants/{variantId}/prices

Prices

POST /api/prices
GET /api/prices/{priceId}
PATCH /api/prices/{priceId}
DELETE /api/prices/{priceId}

Prices attach charge terms to variants. A price becomes metered when it has billable_metric_id.

Meters

GET /api/meters
POST /api/meters
GET /api/meters/{id}

Meters define how usage events aggregate for metered prices.