Skip to main content
GET
List orders for a client

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"

clientId
string
required

The client — the person the booking is for.

Minimum string length: 1
Example:

"cli_01kv6r83j9fmquwl81xkm5bwj6"

Query Parameters

limit
integer
default:50

Maximum rows to return in data, 1–200. Defaults to 50. Values outside the range return 400. A page can still hold fewer rows than requested, so treat nextCursor: null as the only end-of-results signal and never stop on a page that merely looks short.

Required range: 1 <= x <= 200
Example:

50

cursor
string

Opaque pagination token from a previous response's nextCursor. Treat it as a magic string — never parse or construct one. A cursor is only valid for the same filters that produced it, and nextCursor: null means the last page.

Response

Orders list

data
object[]
required
nextCursor
string | null
required