Knowledge Center

Run billing with Floatless.

Product guides, billing concepts, operational playbooks, developer references, and security notes for teams running subscription revenue.

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"
}

List products

curl https://api.floatless.com/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.com/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.

Next steps