Skip to navigation

List bookings

View as Markdown

Returns bookings (not blocks), newest first, paginated.

Filters

  • trip_start / trip_end — trips starting on/after, ending on/before
  • updated_since — ISO 8601; only bookings changed at or after this moment. Use it to poll incrementally.
  • providers — comma-separated sources, e.g. direct,turo
  • includeAbandoned=true / onlyAbandoned=true — include unfinished checkouts
  • limit — page size, 1–500 (default 100); follow links.next to page
  • include — comma-separated: renter, listing, listingImages, vehicle, payment, rentalAgreement, stripeIdentity

Trip and payment fields

  • pickup_location / return_location — where the trip starts and ends: the Turo trip’s address, else the delivery address on the order, else the vehicle’s branch pickup and return spots
  • odometer_start / odometer_end — readings at pickup and return, typed by the host or captured from a connected car; in the company’s distance unit
  • total — the booked total, in cents
  • amount_paid_in_cents — what the renter has paid on the order, refundable security deposits excluded; null when the booking has no order (Turo trips are paid out by Turo)
  • balance_due_in_cents — still owed on the order

Amounts are visible only to tokens whose user can view order financials.

Lookups (return a single match instead of a list)

  • b_id — one booking by ID
  • email or phone — a customer’s bookings

Authentication

AuthorizationBearer

An API token from Settings → API tokens in Fleetwire, sent as Authorization: Bearer …. Each token carries scopes: read for every GET, plus write scopes such as bookings:write.

Query parameters

updated_sincedatetimeOptional
Only bookings changed since this moment
limitintegerOptional1-500
Page size, max 500
includestringOptional
Related data to include
trip_startstringOptional

Trips starting on/after

trip_endstringOptional

Trips ending on/before

providersstringOptional
Filter by source
b_idstringOptional
Look up one booking
emailstringOptional
Look up a customer's bookings

Response

OK
datalist of objectsOptional
metaobjectOptional

Errors

401
Unauthorized Error
422
Unprocessable Entity Error
429
Too Many Requests Error