---
title: "List Bookings"
method: GET
path: "/hotel-bookings"
tags: ["hotel-bookings"]
---

# List Bookings

`GET /hotel-bookings`

## Response `200`

Successful Response

- BookingOut[]
  - `booking_id` string, uuid, required
  - `status` string, required
  - `provider_status` string, nullable, required
  - `provider_booking_id` string, nullable, required
  - `hotel_confirmation_code` string, nullable, required
  - `hotel_id` string, required
  - `hotel_name` string, nullable, required
  - `checkin` string, date, required
  - `checkout` string, date, required
  - `currency` string, required
  - `all_in_total` number, nullable, required
  - `booked_total` number, nullable, required
  - `cancellation_fee` number, nullable, required
  - `refund_amount` number, nullable, required
  - `refundable_tag` string, nullable, required
  - `cancellation_policy` object, nullable, required
  - `rooms_priced` integer, nullable, required
  - `trip_id` string, uuid, nullable, required
  - `stay_tool_call_id` string, nullable, required
  - `sandbox` boolean, required
  - `payment_status` string, nullable, required
  - `payment_model` string, nullable, required
  - `payment_secret` string, nullable, required
  - `prebook_id` string, nullable, required
  - `booking_intent_id` string, nullable, required
  - `drift` DriftReport, required — What changed between what we showed and what LiteAPI will honour. `requires_acknowledgement` is the gate: while it is true and nobody has confirmed, `/book` refuses. Note `price_drift_pct` and `provider_price_difference_pct` are DIFFERENT numbers — LiteAPI computes theirs on `retailRate.total`, so an excluded fee can move the user's price while their flag reads zero.
    - `requires_acknowledgement` boolean, required
    - `price_drift_pct` number, nullable, required
    - `provider_price_difference_pct` number, nullable, required
    - `cancellation_changed` boolean, nullable, required
    - `board_changed` boolean, nullable, required
    - `quoted_all_in_total` number, nullable, required

---

[API](https://skmtc.dev/stardrift/apis/fastapi.md) · [All operations](https://skmtc.dev/stardrift/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stardrift/fastapi/revisions/00746572572a/schema)