Products

Products are marketplace listings — physical goods, digital downloads, services. Each product has a sku (stable per-community id), price + currency, and optional images. Pricing can vary by member tier (see Segments).

Base URL: https://api.cobuntu.com/api/v1

Every endpoint requires an X-API-Key header. See Authentication for scope details.

`GET` `/communities/{communityTag}/products` — List products

Scope: READ_PUBLIC

Path parameters:

Param	Type	Description
`communityTag`	`string`	Your community's tag (e.g. `bela-escala`, `orbis`).

Query parameters:

Param	Type	Default	Description
`limit`	`integer`	20	Page size. Default 20, max 100.
`offset`	`integer`	0	Zero-based offset for pagination. Use either offset or cursor — not both.

Response (200):

[
  {
      "id": "…",
      "sku": "…",
      "name": "…",
      "description": "…"  // nullable,
      "priceCents": 0,
      "currency": "…",
      "imageUrl": "…"  // nullable,
      "isActive": false,
      "sellerId": "…",
    }
]

Field	Type	Description
`id`	`string`	Stable product identifier (uuid).
`sku`	`string`	Stable per-community SKU; use this for deep-links and inventory keys.
`name`	`string`	Display name on product cards + detail pages.
`description`	`string` (nullable)	Long-form description (markdown).
`priceCents`	`integer`	Price in the smallest currency unit.
`currency`	`string`	ISO 4217 code.
`imageUrl`	`string` (nullable)	Primary image (or null).
`isActive`	`boolean`	Whether the product accepts new orders.
`sellerId`	`string`	User id of the member who listed the product (when the community has user-seller stack enabled).

Example:

curl https://api.cobuntu.com/api/v1/communities/my-community/products \
  -H "X-API-Key: pk_live_..."

`GET` `/communities/{communityTag}/products/{sku}` — Get product by SKU