--- title: "Retrieve all bookings" method: GET path: "/bookings/" tags: ["Manage bookings"] --- # Retrieve all bookings `GET /bookings/` ## Request - Base URL: `https://book.liteapi.travel/v3.0` - URL: `https://book.liteapi.travel/v3.0/bookings/` - Auth: API key in header `X-API-Key` ## Overview Get all bookings associated with your API key, with optional filtering by date ranges. Perfect for generating reports and managing your booking inventory. ## When to Use - **Booking reports** - Generate reports of all bookings - **Date range queries** - Find bookings within specific date ranges - **Administrative overview** - View all bookings in your system - **Analytics** - Analyze booking patterns and trends ## What You Get - **Complete booking list** - All bookings linked to your API key - **Filtered results** - Optional filtering by stay dates or booking creation dates - **Booking details** - Full information for each booking - **Status information** - Current status of each booking ## Filtering Options - **Stay period** - Filter by check-in/check-out date range (`startDate`, `endDate`) - **Booking period** - Filter by when bookings were created (`bookingStartDate`, `bookingEndDate`) - **Status** - Filter by booking status (optional) ## Quick Start No parameters required for all bookings. Optionally provide date ranges to filter results. Returns all matching bookings with complete details. ## Query parameters - `startDate` string, date - `endDate` string, date - `bookingStartDate` string, date - `bookingEndDate` string, date - `status` 'confirmed' | 'cancelled' - `paymentStatus` 'succeeded' | 'requires_capture' - `sandbox` '0' | '1' - `customTags` string ## Response `200` The total number of bookings retrieved - object - `count` integer: The total number of bookings returned in the response. - `data` object[] - `id` integer, required: The unique identifier for the booking record. - `checkin` string, required: The check-in date for the booking (YYYY-MM-DD). - `checkout` string, required: The check-out date for the booking (YYYY-MM-DD). - `feed` string: Which feed was used for this booking. Null if the default feed was used. - `firstName` string: The first name of the person responsible for the booking. - `lastName` string: The last name of the person responsible for the booking. - `adults` integer: The number of adult guests in the booking. - `children` string: A comma delimited string of children's ages included in the booking. Can be empty if no children are included. - `hotel_confirmation_code` string: A unique confirmation code issued by the hotel. - `bookingId` string, required: The unique identifier for this booking - `prebook_Id` string: The prebook ID used to confirm the booking. - `status` string, required: The current status of the booking (e.g., CONFIRMED, CANCELED). - `payment_status` string: The status of the payment for this booking. - `payment_transaction_id` string: The transaction ID for the payment processed for this booking. - `retail_rate` string: The total cost of the booking in the specified currency. - `exchange_rate` number: The exchange rate used for converting to EUR - `exchange_rate_usd` number: The exchange rate used for converting to USD. - `email` string: The email address associated with the booking. - `cancelPolicies` string: A JSON string containing the cancellation policy details, including penalties and deadlines. - `tag` string: Indicates if the booking is refundable ('RFN' for refundable, 'NRFN' for non-refundable). - `last_free_cancellation_date` string: The latest date/time when the booking can be canceled without penalties (ISO 8601 format). - `currency` string, required: The currency in which the booking was processed. - `nationality` string: The nationality of the primary guest, represented in ISO 2-letter country code format. - `holder_title` string: The title (Mr, Ms, Dr, etc.) of the person holding the booking. Can be empty. - `hotelId` string: The unique identifier for the hotel associated with this booking. - `Hotel_name` string: The name of the hotel associated with this booking. - `payment_data` string: A JSON string containing additional payment details. Can be empty. - `created_at` string: The timestamp when the booking was created (ISO 8601 format). - `updated_at` string: The timestamp when the booking details were last updated (ISO 8601 format). - `cancelled_at` string: The timestamp when the booking was canceled. Null if not canceled. - `refunded_at` string: The timestamp when the booking was refunded. Null if not refunded. - `amount_refunded` number: The total amount refunded for this booking, if applicable. - `refund_type` string: The type of refund issued, if applicable. - `guestId` string: The unique identifier for the guest associated with the booking. - `reqId` string: The request ID associated with this booking request. - `remarks` string: Any additional remarks or notes related to the booking. - `hotelRemarks` string: Any additional remarks or notes related to the hotel. - `client_reference` string: A reference string provided by the client for tracking the booking. - `IP` number: The IP address from which the booking request was made. - `sandbox` number: Indicates if this booking was made in a test/sandbox environment (0 for false, 1 for true). - `version` number: The API version used for this booking request. - `link` number: A tracking or reference link related to the booking. Can be 0 if not applicable. - `client_commission` number: The commission amount received by the client for this booking. - `voucher_id` string: The unique identifier for any voucher applied to this booking. - `voucher_total_amount` number: The total amount covered by the voucher, if applicable. - `voucher_transation_id` string: The transaction ID associated with the voucher used for payment. - `processing_fee` number: The processing fee charged for this booking. - `supplier_Booking_Id` string: The unique booking ID assigned by the supplier. - `tracking_id` string: The campaign ID passed in from the client. ## Other responses - `400`: Bad request, missing or invalid parameters. - `401`: Unauthorized access. --- [API](https://skmtc.dev/liteapi/apis/api-booking.md) - [All operations](https://skmtc.dev/liteapi/apis/api-booking/llms.txt) - [OpenAPI document](https://skmtc.dev/liteapi/apis/api-booking/revisions/f7aa5ddc692b?raw)