Skip to main content
GET
List the signed-in supplier’s bookings

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.

Authorization
string
header
required

The signed-in person's Cognito access token, issued to this application's app client. Sent with the API key on the /clients/me and /suppliers/me routes.

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"

Query Parameters

startDate
string<date-time>

Earliest booking start to include (ISO 8601 instant, UTC). A single day is one day’s window.

Example:

"2026-10-19T00:00:00.000Z"

endDate
string<date-time>

Latest booking start to include (ISO 8601 instant, UTC).

Example:

"2026-10-26T00:00:00.000Z"

status
enum<string>

Only bookings in this status.

Available options:
SCHEDULED,
STARTED,
AWAITING_CONFIRMATION,
DISPUTED,
COMPLETED,
CANCELLED,
CLIENT_NO_SHOW,
SUPPLIER_NO_SHOW,
NO_SHOW
Example:

"SCHEDULED"

expand
string

Comma-separated set of expansions, any order: client, services, package, location, participants, myReport. Each adds one optional key, absent unless requested. Unknown values are rejected. Every value except client requires startDate and endDate, at most 93 days apart.

Example:

"client,services,location,participants,myReport"

Response

Bookings list

data
object[]
required