--- title: "Retrieve a booking" method: GET path: "/bookings/{bookingId}" tags: ["Manage bookings"] --- # Retrieve a booking `GET /bookings/{bookingId}` ## Overview Get complete details for a specific booking by its booking ID. Returns all booking information including status, guest details, pricing, and cancellation policies. ## When to Use - **Booking details page** - Display complete booking information - **Status checks** - Verify current booking status - **Confirmation lookup** - Retrieve booking confirmation details - **Support queries** - Look up booking information for customer service ## What You Get - **Complete booking details** - All information about the booking - **Booking status** - Current status (confirmed, cancelled, etc.) - **Guest information** - Name, email, and contact details - **Stay information** - Check-in/check-out dates, hotel details - **Pricing breakdown** - Total cost, taxes, fees, and payment status - **Cancellation policies** - Terms and conditions for cancellation - **Hotel confirmation** - Hotel confirmation code and reference ## Quick Start Provide the `bookingId` in the URL path. Returns complete booking details including status and all associated information. ## Path parameters - `bookingId` string, required ## Query parameters - `timeout` number, float ## Response `200` OK - object - `data` object - `bookingId` string, required — The unique identifier for the confirmed booking. This is used to reference the booking later via the API or calls for support. - `clientReference` string — A reference ID provided by the client (you) for tracking purposes. - `supplierBookingId` string — The booking ID assigned by the supplier. Not needed, use bookingId instead. - `supplierBookingName` string — The name associated with the booking in the supplier's system. By default, Nuitee. - `supplier` string — The supplier handling this booking. By default, Nuitee. - `supplierId` integer — The unique numerical identifier for the supplier. By default, 2 for Nuitee. - `feed` string — Which feed was used for this booking. Null if the default feed was used. - `status` string, required — The current status of the booking. At this point it will be CONFIRMED, the other option for this field is CANCELED. - `hotelConfirmationCode` string — The confirmation code issued by the hotel for the booking. Not available at booking time. Nuitee performs a manual process to to contact the hotel and get the confirmation number. - `checkin` string, required — The check-in date for the booking (ISO format). - `checkout` string, required — The check-out date for the booking (ISO format). - `hotel` object - `hotelId` string — The unique identifier of the hotel. - `name` string — The name of the hotel. - `bookedRooms` object[] - `roomType` object — An object containing details about the booked room type. - `roomTypeId` string — Unique identifier for the room type. - `name` string — The name of the booked room type. - `boardType` string — A short code representing the meal plan included with the booking. - `boardName` string — The full name of the meal plan included in the booking. - `adults` integer — Number of adults in this room. - `children` integer — Number of children in this room. - `rate` object — An object containing rate information for the booked room. - `rateId` string — The unique identifier for a specific rate within the offer. - `retailRate` object — An object with details about the retail price of the booking. - `total` object — an object containing the total cost of the rate - `amount` integer — The total cost amount due to book this room. This is what the end user will pay. - `currency` string — The currency the total is in. - `cancellationPolicies` object — An object containing the cancellation rules and conditions for the booking. - `cancelPolicyInfos` object[] — An array of objects detailing specific cancellation penalties and deadlines. - `cancelTime` string — The deadline to cancel before incurring a fee (ISO datetime format). - `amount` number — The monetary penalty applied if the booking is canceled after the deadline. Can be 0 which means its fully refundable. - `currency` string — The currency of the cancellation fee. - `type` string — The type of cancellation penalty (e.g., 'amount' for a fixed fee). - `timezone` string — The timezone in which the cancellation policy applies. Always GMT, even if not listed. - `hotelRemarks` object[] — An array of additional remarks from the hotel regarding cancellations. - `refundableTag` string — Indicates whether the booking is refundable, Either 'NRFN' for non-refundable or RFN for refundable. - `maxOccupancy` integer — The maximum number of guests allowed in this room. - `boardType` string — A short code representing the meal plan included with the booking. - `boardName` string — The full name of the meal plan included in the booking. - `remarks` string — Any special remarks related to the booking or room type. - `perks` object[] — An array of perks or benefits associated with this rate. - `perkId` integer — Unique identifier for the perk. - `name` string — The name or description of the perk. - `amount` number — The monetary value of the perk. - `currency` string — The currency of the perk amount. - `level` string — The level or tier of the perk. - `firstName` string — The first name of the person responsible for the booking. - `lastName` string — The last name of the person responsible for the booking. - `childrenAges` integer[], nullable — Ages of children in this room. - `board` string — The full name of the meal plan included in the booking. - `boardCode` string — A short code representing the meal plan included with the booking. - `cancellationPolicies` object — An object containing the cancellation rules and conditions for the booking. - `cancelPolicyInfos` object[] — An array of objects detailing specific cancellation penalties and deadlines. - `cancelTime` string — The deadline to cancel before incurring a fee (ISO datetime format). - `amount` number — The monetary penalty applied if the booking is canceled after the deadline. Can be 0 which means its fully refundable. - `currency` string — The currency of the cancellation fee. - `type` string — The type of cancellation penalty (e.g., 'amount' for a fixed fee). - `timezone` string — The timezone in which the cancellation policy applies. Always GMT, even if not listed. - `hotelRemarks` object[] — An array of additional remarks from the hotel regarding cancellations. - `refundableTag` string — Indicates whether the booking is refundable, Either 'NRFN' for non-refundable or RFN for refundable. - `room_id` string — Unique identifier for the room. - `occupancy_number` integer — Occupancy number within this booking. - `amount` number — Room price for this booking. - `currency` string — Currency code for the room cost. - `children_count` integer — Number of children in this room. - `remarks` string — Additional remarks for this room. - `guests` object[] — Guest details for this room. - `firstName` string — Guest's first name. - `lastName` string — Guest's last name. - `email` string — Guest's email address. - `phone` string — Guest's phone number. - `remarks` string — Remarks specific to this guest. - `occupancyNumber` integer — Occupancy number for this guest. - `holder` object — An object containing details of the person responsible for the booking. - `firstName` string — The first name of the person responsible for the booking. - `lastName` string — The last name of the person responsible for the booking. - `email` string — The email address of the person responsible for the booking. - `phone` string — The phone number of the person responsible for the booking. - `createdAt` string, required — Timestamp when the booking was created. - `updatedAt` string — Timestamp when the booking was last updated. - `cancellationPolicies` object — An object containing the cancellation rules and conditions for the booking. - `cancelPolicyInfos` object[] — An array of objects detailing specific cancellation penalties and deadlines. - `cancelTime` string — The deadline to cancel before incurring a fee (ISO datetime format). - `amount` number — The monetary penalty applied if the booking is canceled after the deadline. Can be 0 which means its fully refundable. - `currency` string — The currency of the cancellation fee. - `type` string — The type of cancellation penalty (e.g., 'amount' for a fixed fee). - `timezone` string — The timezone in which the cancellation policy applies. Always GMT, even if not listed. - `hotelRemarks` object[] — An array of additional remarks from the hotel regarding cancellations. - `refundableTag` string — Indicates whether the booking is refundable, Either 'NRFN' for non-refundable or RFN for refundable. - `specialRemarks` string — Special requests or remarks for the booking. - `optionalFees` string — Optional fees associated with the booking. - `mandatoryFees` string — Mandatory fees associated with the booking. - `knowBeforeYouGo` string — Important information for the guest. - `price` number, required — The final total price of all rooms on the booking. - `commission` number — The total commission amount associated with all rooms on the booking. - `addonsTotalAmount` number — The total amount charged for any additional services or extras. - `currency` string, required — The currency in which the booking price is displayed. - `remarks` string — Any additional notes related to the booking. - `hotelRemarks` string — Hotel-specific remarks from the booking. - `voucherCode` string — A code associated with the addon voucher, if applicable. - `voucherTotalAmount` number — Total amount covered by a voucher. - `addons` object[] — A list of additional services or extras that can be added to the booking. For example, adding an Uber voucher or an esim card. The final booking amount is the sum of the offer's total price and the cost of any addons. Each addon's price is added individually to reflect all extras in the billed total. - `addon` string — The type of addon service (e.g., uber, esimply). - `value` number — The monetary cost of the addon service - `currency` string — The currency in which the addon service is charged - `addonDetails` object - `package_id` integer — Unique identifier of the addon package - `destination_code` string — Short code representing the destination or country (e.g., ES for Spain) - `start_date` string — The start date for the add-on service (YYYY-MM-DD format) - `end_date` string — The end date for the add-on service (YYYY-MM-DD format) - `guestId` integer — Guest ID associated with the booking. - `distributorCommission` number — Commission amount for the distributor. - `distributorPrice` number — Price after distributor commission. - `trackingId` string — Tracking identifier for the booking. - `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. - `childrenCount` integer — Number of children in the booking. - `prebookId` string — Identifier from the pre-booking step. - `paymentStatus` string — Status of the payment for the booking. - `paymentTransactionId` string — Transaction identifier for the payment. - `sellingPrice` string — Total selling price of the booking. - `exchangeRate` number — Exchange rate used for currency conversion. - `exchangeRateUsd` number — USD exchange rate for the booking. - `email` string — Email of the guest or booking holder. - `tag` string — Indicates if the booking is refundable ('RFN' for refundable, 'NRFN' for non-refundable). - `lastFreeCancellationDate` string — The latest date/time when the booking can be canceled without penalties (ISO 8601 format). - `userId` integer — ID of the user who made the booking. - `nationality` string — Nationality of the guest. - `holderTitle` string — Title of the main guest/holder. - `hotelId` string — The unique identifier for the hotel associated with this booking. - `hotelName` string — The name of the hotel associated with this booking. - `cancelledAt` string — Timestamp when the booking was cancelled. - `refundedAt` string — Timestamp when the booking was refunded. - `loyaltyGuestId` object — Loyalty or membership ID of the guest. - `sandbox` integer — Indicates if this booking is in sandbox mode (0 or 1). - `clientCommission` number — Commission amount for the client. - `voucherId` integer — ID of any voucher used. - `voucherTransationId` string — Transaction ID associated with the voucher. - `processingFee` number — Processing fee for the booking. - `amountRefunded` number — Total amount refunded for this booking. - `refundType` string — Type of refund (e.g., full, partial). - `paymentScheduledAt` string — Scheduled time for the payment process. - `addonsRedemptions` object — Details of any add-on redemptions. - `rebookFrom` string — Original booking ID if this booking was rebooked. - `agentId` object — ID of the agent who made the booking, if applicable. - `cancelledBy` object — User ID or agent ID who cancelled the booking. - `checkinInstructions` object — Check-in instructions provided by the property, including contact information and special requirements. - `idRequired` boolean — Whether guest identification is required at check-in. - `propertyContact` object — Contact information for the property. - `email` string, nullable — Property email address for guest communication. - `phone` string, nullable — Property phone number for guest communication. - `hasCommunication` boolean — Whether guest communication with the property is required before arrival. - `instructions` string — Detailed check-in instructions from the property. - `arrivalTimeRequested` boolean — Whether the property requests guest to provide their expected arrival time. - `checkinSourceEventId` string — Unique identifier for the source event that provided these instructions. - `updatedAt` string, date-time — Timestamp when the check-in instructions were last updated (ISO 8601 format). - `customTags` object — User-defined key/value labels persisted at booking time. Keys match `^[A-Z0-9_-]+$`, values are strings up to 255 characters, capped at 5 entries. ## Other responses - `204` — No Content - `401` — Unauthorized --- [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)