--- title: "Retrieve all bookings" method: GET path: "/bookings/" tags: ["Manage bookings"] --- # Retrieve all bookings `GET /bookings/` ## 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.net/liteapi/apis/api-search.md) · [All operations](https://skmtc.net/liteapi/apis/api-search/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/liteapi/api-search/versions/315ba2a4dcf4/schema)