List a page of bookings for authenticated account

get

https://example.com/v1/bookings/page

Return an offset-paginated page of bookings for the authenticated account. The same filters as GET /v1/bookings apply; results are served from Mercury's booking mirror with no per-request upstream fetch. meta.totalCount is the mirror count — not a live upstream total. A booking made outside Mercury appears once the mirror receives it (change feed, or the hourly background sync at the latest).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

vertical

enum

Filter by travel vertical.

status

array | null

Filter by one or more statuses (repeat to combine, e.g. ?status=confirmed&status=pending).

tripId

Filter to bookings associated with this trip UUID.

sort

enum

Order by departure time (ASC oldest first, DESC newest). Omit for legacy creation-time order.

departureDateFrom

Inclusive departure-date lower bound (YYYY-MM-DD).

departureDateTo

Inclusive departure-date upper bound (YYYY-MM-DD).

limit

integer

1 to 100

Defaults to 20

offset

integer

≥ 0

Defaults to 0

createdBy

length ≤ 64

Exact match against Mercury's locally stored booking owner id. Normally the booker; when the upstream omitted that field, the deterministic syncing-user fallback is stored instead.

travelers

array | null

Filter by one or more opaque traveler user ids (repeat to combine with OR semantics). Applied locally before pagination.

Responses

401

Missing or invalid authentication

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successful Response

422Invalid filter combination (e.g. departureDateFrom > departureDateTo).