API Reference
  1. travel.tech API
  2. Bookings

List a page of bookings for authenticated account

get
https://api.travel.tech/v1/bookings/page

Return an offset-paginated page of bookings for the authenticated account. The same filters as GET /v1/bookings apply, including self-scoped createdByMe and travelingOnly (no client user id). 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
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

Updated 17 days ago

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

Updated 17 days ago

Did this page help you?