API reference

The headless API is a small REST API over your published bundles. Every endpoint requires a Bearer API key and lives under one base URL.

Base URL

https://live.bb.eight-cdn.com/api/headless/v1

The SDK uses this by default; override with baseUrl for staging or local dev.

Auth: Authorization: Bearer kit_live_… on every request. See Authentication.
Content type: application/json for request and response bodies.
IDs: bundle and section IDs are integers; product/variant IDs are returned both as numeric strings and as Shopify GIDs (gid://shopify/ProductVariant/123).
Money: prices are strings formatted to two decimals (e.g. "29.99").
Rate limit: 100 requests/minute per key by default. See Rate limits.

GET /bundles

List published bundles.

GET /bundles/:id

Full bundle configuration (sections, discount, rules, required products).

GET /bundles/:id/products

Product and variant data (price, SKU, availability, inventory).

POST /bundles/:id/configure

Validate a selection, create a configured bundle, return cart data.

POST /bundles/:id/price

Calculate pricing for a selection (no configuration created).

GET /settings

Shop settings (currency, money format, active features).

Full endpoint reference

Request bodies, query params and exact response shapes for every endpoint.

Errors

Status codes and error body shapes for 400 / 403 / 404 / 429.