List bookings for authenticated account

Return bookings for the authenticated account from Mercury's booking mirror, optionally filtered by vertical, status, trip, booker, traveler, self-booked (createdByMe), self-traveling (travelingOnly), departure date range, or sort order. createdByMe and travelingOnly take no user id; they resolve from the authenticated caller. When no status[] filter is supplied, bookings in failed or voided status are excluded by default (they never became usable). Pass an explicit status[] to include them. All filters apply to the local mirror before pagination. This request does not call upstream or write to the database. A booking made outside Mercury appears once the mirror receives it (change feed, or the hourly background sync at the latest).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
enum

Filter by travel vertical.

array | null

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

Filter to bookings associated with this trip UUID.

enum

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

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

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

integer
1 to 100
Defaults to 20
integer
≥ 0
Defaults to 0
length ≤ 64

Filter to bookings owned by this booker. Accepts the caller's public profile id — the GET /v1/profile identity.id uuid5. A raw internal user id is not accepted and is rejected with HTTP 422.

array | null

Filter by one or more travelers (repeat to combine with OR semantics). Applied locally before pagination. Each value is a public traveler id — the booking travelerId / identity.id uuid5. A raw internal user id is not accepted and is rejected with HTTP 422.

boolean
Defaults to false

When true, restrict to bookings the authenticated caller booked. Takes no user id. Incompatible with createdBy (HTTP 422).

boolean
Defaults to false

When true, restrict to bookings the authenticated caller travels on (local traveler projection). Takes no user id. Incompatible with travelers (HTTP 422).

Responses

401

Missing or invalid authentication

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json