Skip to main content
GET
List packages for an offering (storefront)

Authorizations

x-api-key
string
header
required

API key minted in the MarketBox dashboard. Scope is restricted to the projects you select at creation time. Every route needs the key's standard API access (*) except POST /v1/projects/{projectId}/events, which needs events:write; a key without * is refused with 403 CAPABILITY_NOT_GRANTED.

Path Parameters

projectId
string
required

The project (tenant) that owns the resource. Every resource in this API is scoped to a project, and your API key is restricted to the projects it was issued for — a project outside that scope returns 403.

Minimum string length: 1
Example:

"prj_01kv60qgnef2kt3pvqgwmkbzfr"

serviceId
string
required

The service — the sellable thing (a lesson, a treatment). Offerings hang off a service and carry the duration and price.

Minimum string length: 1
Example:

"srv_01kv60qg12e82acr78edfnjhvv"

offeringId
string
required

The offering — one bookable variant of a service, carrying its own duration and regional pricing rules.

Minimum string length: 1
Example:

"off_01kv60qge5eh59ap0gw0pqrrys"

Query Parameters

status
enum<string>

Lifecycle of the package bundle. ARCHIVED hides it from the storefront and blocks new orders, but order items already placed against it stay bookable.

Available options:
DRAFT,
ACTIVE,
ARCHIVED

Response

Packages

data
object[]
required
nextCursor
string | null
required