Products API
Products represent the catalog items used by subscriptions, invoices, and usage-based pricing.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /products |
List products |
| GET | /products/{product_id} |
Retrieve a product |
The Product object
{
"id": 42,
"object": "product",
"name": "API Calls",
"sku": "api-calls",
"description": "Metered API call usage",
"unit_price": "0.01000000",
"currency": "USD",
"unit_label": "call",
"category": "usage",
"product_type": "standard",
"pricing_type": "usage",
"pricing_model": "per_unit",
"pricing_scheme": "linear",
"pricing_mode": null,
"default_billing_period": "monthly",
"external_id": "api_calls",
"is_active": true,
"metadata": {},
"created_at": "2026-07-07T10:00:00Z",
"updated_at": "2026-07-07T10:00:00Z"
}
Enum values on products are lowercase: product_type standard | bundle, pricing_type one_time | recurring | usage, pricing_model flat_fee | per_unit, pricing_scheme linear | tiered, pricing_mode flat | volume | graduated (null unless tiered), default_billing_period monthly | quarterly | annually.
List products
curl https://api.floatless.ca/api/public/v1/products \
-H "Authorization: Bearer sk_live_..."
Query parameters
| Parameter | Type | Description |
|---|---|---|
active |
boolean | Filter by active status |
limit |
integer | Number of results, 1 to 100 |
offset |
integer | Pagination offset |
Retrieve a product
curl https://api.floatless.ca/api/public/v1/products/42 \
-H "Authorization: Bearer sk_live_..."
Notes
- Product write operations are currently managed from the authenticated product console and internal APIs.
- Public product reads are intended for integration sync, catalog mapping, and subscription item reconciliation.