# liteAPI Documentation > Welcome to the Nuitee Connect Developer Documentation. This guide provides all the information you need to integrate Nuitee Connect and LiteAPI into your applications. Whether you are building a simple website or a complex booking system, our APIs offer flexible and powerful tools to meet your needs. Nuitee Connect is designed to be easy to use and highly efficient, ensuring that you can focus on building great features for your users. Our API provides seamless access to a wide range of hotel data, including availability, rates, and booking options, making it the perfect choice for travel and hospitality applications. ## Guides: INTRODUCTION - [Overview](https://docs.liteapi.travel/docs/docs.md): High-level overview of Nuitee Connect — search, prebook, and book hotels from your app. - [FAQ](https://docs.liteapi.travel/docs/faq.md) ## Guides: Build with liteAPI - [Booking a Room](https://docs.liteapi.travel/docs/booking-a-room.md): This guide walks through booking a room using a sandbox API key. - [Step 1: Getting an API Key](https://docs.liteapi.travel/docs/getting-a-sandbox-key.md) - [Step 2: Requesting room rates](https://docs.liteapi.travel/docs/step-2-requesting-room-rates.md) - [Step 3: Pre-booking a room](https://docs.liteapi.travel/docs/step-3-pre-booking-a-room.md) - [Step 4: Booking a Room](https://docs.liteapi.travel/docs/step-4-booking-a-room.md) - [Searching for hotels](https://docs.liteapi.travel/docs/preparing-a-list-of-hotel-ids.md) - [Implementing a Payment Method](https://docs.liteapi.travel/docs/implementing-payment.md) - [1. User Payment (Nuitee SDK)](https://docs.liteapi.travel/docs/user-payment.md): Use Nuitee Connect's payment SDK to accept user payment - [Alternative - User payment with Stripe SDK](https://docs.liteapi.travel/docs/direct-stripe-integration-stripe-elements.md): Integrate Stripe Elements directly into your checkout to accept user payments for LiteAPI bookings, with full control over the payment UI. - [2. Account Credit Card](https://docs.liteapi.travel/docs/account-credit-card.md): Pay directly from the account’s credit card. - [3. Credit Line Payments](https://docs.liteapi.travel/docs/credit-line.md): This method is used when you have contracted a credit line - [Displaying Essential Hotel Details](https://docs.liteapi.travel/docs/displaying-hotel-details.md) - [Room Details](https://docs.liteapi.travel/docs/room-details.md) - [Hotel Reviews](https://docs.liteapi.travel/docs/hotel-reviews.md) - [Rate and Hotel Query Guide](https://docs.liteapi.travel/docs/rate-request-parameters-guide.md) - [Hotel Rates API JSON Data Structure](https://docs.liteapi.travel/docs/hotel-rates-api-json-data-structure.md) - [Adding guests during the booking step](https://docs.liteapi.travel/docs/adding-guests-during-the-booking-step.md) - [Canceling a Booking](https://docs.liteapi.travel/docs/canceling-a-booking.md) - [Hotel Integration Guide](https://docs.liteapi.travel/docs/hotel-integration-guide.md): This guide covers the recommended architecture and workflow for building a hotel booking experience - [Getting Access to Flights](https://docs.liteapi.travel/docs/getting-access-to-flights.md): The Flights API allows you to search, price, and book flights through Nuitee Connect. - [Build a Flight Booking Experience](https://docs.liteapi.travel/docs/build-a-flight-booking-experience.md): Nuitee Connect aggregates real-time flight inventory from GDS, NDC, and LCC providers into a single API. - [Booking Flow Recipes](https://docs.liteapi.travel/docs/booking-flow-recipes.md): Practical implementation patterns for common flight booking scenarios using Nuitee Connect. - [Flight Booking Architecture](https://docs.liteapi.travel/docs/flight-booking-architecture.md): A practical reference for engineering teams building production flight booking systems on Nuitee Connect - [Flight Seat Map — Implementation Guide](https://docs.liteapi.travel/docs/flight-seat-map-implementation-guide.md): How the seat map works in the whitelabel frontend, from API data to rendered grid. Use this as a reference if you're building a seat map from the same data source. - [Flights — Support & Billing Model](https://docs.liteapi.travel/docs/flights-support-billing-model.md): How Nuitée services flight bookings, how airline changes reach your system, and how servicing costs settle. ## Guides: Pre-built Booking Site - [Whitelabel Booking Site](https://docs.liteapi.travel/docs/whitelabel-booking-site.md) - [Whitelabel Appearance](https://docs.liteapi.travel/docs/customizing-appearance.md): Configuring the Appearance of Your White Label Booking Site - [Whitelabel Configuration](https://docs.liteapi.travel/docs/configuring-your-liteapi-powered-white-label-booking-site.md): Configuring Your Nuitee Connect-Powered White Label Booking Site - [Deeplinking to Whitelabel](https://docs.liteapi.travel/docs/deeplinking-to-whitelabel.md): This guide explains how to use URL parameters to deep link to the Hotel Listing, Hotel Details, and Checkout pages with pre-filled data. It includes parameter descriptions, values, and examples for… - [Single Sign-On Deep Link](https://docs.liteapi.travel/docs/single-sign-on-deep-link-guide.md): This guide explains how to integrate External Auth SSO into your whitelabel project. Your backend requests a one-time magic login link from our API using a signed payload. When the user is redirected… - [Password-Protected Site Access (`id` + `sig`)](https://docs.liteapi.travel/docs/password-protected-site-access-id-sig.md) - [Custom Domain Guide](https://docs.liteapi.travel/docs/custom-domain-guide.md): This guide walks you through the entire process of configuring your domain to point to your website hosted on our platform. - [Whitelabel - Loyalty Program](https://docs.liteapi.travel/docs/loyalty-program-1.md): Wire your existing loyalty and rewards program into the WhiteLabel hotel booking flow. Guests can earn points, see rewards, and track benefits during search and checkout. - [Loyalty Program - No Validation Required](https://docs.liteapi.travel/docs/loyalty-program-no-validation-required.md): This document covers the **No Validation Required** method in detail. For general loyalty program information, see the overview document. - [Loyalty Program - Membership Number Validation](https://docs.liteapi.travel/docs/loyalty-program-membership-number-validation.md): This document covers the **Membership Number Validation** method in detail. For general loyalty program information, see the overview document. - [Hotel Ranking & Sorting Logic](https://docs.liteapi.travel/docs/hotel-ranking-sorting-logic.md): The Nuitee Connect WhiteLabel interface sorts hotel search results using a **weighted scoring system** designed to balance price competitiveness, quality, location relevance, and popularity. This… - [External Checkout - Integration Guide](https://docs.liteapi.travel/docs/external-checkout-integration-guide.md) - [External Checkout — Dashboard Setup Guide](https://docs.liteapi.travel/docs/external-checkout-dashboard-setup-guide.md): Partner teams setting up External Checkout from the Nuitée partner dashboard - [External Checkout — Endpoint Reference](https://docs.liteapi.travel/docs/external-checkout-endpoint-reference.md): Partner engineering teams implementing the External Checkout integration ## Guides: Guides - [Vouchers API Guide](https://docs.liteapi.travel/docs/vouchers-api-guide.md) - [Revenue Management and Commission](https://docs.liteapi.travel/docs/revenue-management-and-commission.md) - [Nuitee Managed (Dynamic) Pricing](https://docs.liteapi.travel/docs/nuitee-managed-dynamic-pricing.md): Let the market drive your prices - [Perks and Promotions](https://docs.liteapi.travel/docs/perks-and-promotions.md) ## Guides: integrations - [GraphQL Overview](https://docs.liteapi.travel/docs/overview-graphql.md): Search rates, prebook, and book hotels with the Nuitee Connect GraphQL API. Request only the fields you need in one query. - [Getting Started](https://docs.liteapi.travel/docs/getting-started-3.md) - [1. Search offers (Rates search)](https://docs.liteapi.travel/docs/avail.md): This GraphQL query allows developers to retrieve detailed rate information for hotels, supporting multi-room bookings. By making a request with the required parameters, you receive an array of… - [2. Validate an offer (Prebook)](https://docs.liteapi.travel/docs/valuation.md): The **Valuation query** (also known as **Prebook**) is used to verify that a selected hotel rate is still available before proceeding with the booking. - [3. Book (Confirm a booking)](https://docs.liteapi.travel/docs/reservation.md): The Booking Mutation is the final step in the reservation process, where a confirmed booking is created using the Prebook ID. ## Guides: Cookbooks - [Building a Nuitee Connect app on Node.js](https://docs.liteapi.travel/docs/nodejs-cookbook.md) ## Guides: NO-CODE WIDGETS - [Integrate a Hotels List Widget](https://docs.liteapi.travel/docs/integrate-a-hotels-list-widget.md): In this tutorial, you will learn how to integrate and use the Nuitee Connect Hotels List Widget in your web application to display a dynamic, interactive list of hotels. Follow the steps below to get… - [Integrate a Map Widget](https://docs.liteapi.travel/docs/integrate-a-map-widget.md): In this tutorial, you will learn how to integrate and use the Nuitee Connect Map Widget in your web application to display a dynamic, interactive map. Follow the steps below to get started. - [Integrate a Search Bar Widget](https://docs.liteapi.travel/docs/integrate-a-search-bar-widget.md): In this tutorial, you will learn how to integrate and use the Nuitee Connect Search Bar Widget in your web application to display a dynamic, interactive search bar. Follow the steps below to get… ## Guides: ADVANCED USE - [Stream Hotel Rates](https://docs.liteapi.travel/docs/stream-hotel-rates.md) - [Weather Data API Endpoint](https://docs.liteapi.travel/docs/weather-data-api-endpoint.md) - [Add-ons: Adding Amenities to a Booking](https://docs.liteapi.travel/docs/attaching-add-ons-to-user-payment.md): Add Ons are amenities that can be added on to hotel bookings during the checkout process. - [Using Nuitee Connect webhooks](https://docs.liteapi.travel/docs/using-liteapi-webhooks.md) ## Guides: Security, Privacy & Compliance - [Security Overview](https://docs.liteapi.travel/docs/security-privacy-compliance-overview.md): Nuitee Connect is designed with security, privacy, and regulatory compliance as foundational principles. We understand that our customers operate in regulated environments and rely on Nuitee Connect… - [Data Protection & Privacy](https://docs.liteapi.travel/docs/data-protection-privacy.md): Nuitee Connect is committed to protecting the confidentiality, integrity, and availability of data processed through its platform. This page describes how Nuitee Connect handles personal data and… - [Data Processing Agreement (DPA)](https://docs.liteapi.travel/docs/data-processing-agreement-dpa-europe.md): This page describes the data protection and processing commitments applicable to customers subject to European data protection laws, including the **EU General Data Protection Regulation (GDPR)**.… - [Regulatory Compliance](https://docs.liteapi.travel/docs/regulatory-compliance.md): Nuitee Connect is designed to operate in compliance with applicable legal and regulatory requirements related to data protection, payment security, and information security. This page outlines Nuitee… - [Data Encryption](https://docs.liteapi.travel/docs/data-encryption.md): Nuitee Connect uses industry-standard encryption mechanisms to protect data both in transit and at rest. Encryption is a core control to ensure the confidentiality and integrity of customer data… - [Authentication & Access Control](https://docs.liteapi.travel/docs/authentication-access-control.md): Nuitee Connect implements strict authentication and access control mechanisms to ensure that only authorized users and systems can access its APIs and internal systems. - [Infrastructure & Hosting Security](https://docs.liteapi.travel/docs/infrastructure-hosting-security.md): Nuitee Connect operates on secure, modern cloud infrastructure designed to ensure high availability, resilience, and strong security controls. Infrastructure security is a foundational component of… - [Logging, Monitoring & Incident Response](https://docs.liteapi.travel/docs/logging-monitoring-incident-response.md): Nuitee Connect maintains logging, monitoring, and incident response processes designed to detect, respond to, and mitigate security and operational incidents in a timely manner. - [Vulnerability Management](https://docs.liteapi.travel/docs/vulnerability-management.md): Nuitee Connect maintains a vulnerability management program to identify, assess, and remediate security vulnerabilities in a timely manner. The goal is to reduce risk and continuously improve the… - [Data Residency & International Data Transfers](https://docs.liteapi.travel/docs/data-residency-international-data-transfers.md): Nuitee Connect processes and stores data in accordance with applicable data protection laws, including requirements related to data residency and international data transfers. - [Business Continuity & Disaster Recovery](https://docs.liteapi.travel/docs/business-continuity-disaster-recovery.md): Nuitee Connect maintains business continuity and disaster recovery practices designed to ensure service availability, protect data, and support timely recovery in the event of system failures,… - [Performance, Reliability & Rate Limiting](https://docs.liteapi.travel/docs/performance-reliability-rate-limiting.md): Nuitee Connect is designed to provide reliable, predictable API performance at scale. This page describes Nuitee Connect’s performance characteristics, availability targets, rate limiting behavior,… - [Service Availability & Uptime Commitment](https://docs.liteapi.travel/docs/service-availability-uptime-commitment.md): Nuitee Connect is designed to provide a highly available and reliable service for travel search and booking operations. This page outlines Nuitee Connect’s service availability objectives, uptime… ## Guides: MCP Server - [MCP](https://docs.liteapi.travel/docs/mcp.md) ## API Reference: INTRODUCTION - [Overview](https://docs.liteapi.travel/reference/overview.md): Go from zero to live hotel search and booking in hours. REST API, production-like sandbox, and clear docs — search, prebook, book. - [Simple Authentication](https://docs.liteapi.travel/reference/authentication.md): All requests to Nuitee Connect must be authenticated using an API key. You can find your API key in the Nuitee Connect dashboard. An account provides analytics and management for all bookings through… - [HMAC Authentication](https://docs.liteapi.travel/reference/secure-authorization.md): Nuitee Connect also provides a secure method for authenticating requests without directly transmitting your private API key. Instead, you can sign your request using HMAC SHA-512 and include the… - [Getting Started With Nuitee Connect](https://docs.liteapi.travel/reference/getting-started-1.md): Learn how to quickly get up and running with Nuitee Connect. Follow these steps to start making API calls in minutes. - [API Pricing & Usage Costs](https://docs.liteapi.travel/reference/api-pricing-usage-costs.md): Nuitee Connect follows a transparent, usage-based pricing model with **monthly billing cycles**. This page describes API request costs per endpoint category, as well as additional billable features… ## API Reference: DISCOVER - [Hotel Booking workflow](https://docs.liteapi.travel/reference/workflow.md): The Nuitee Connect product streamlines the process of fetching and booking hotel accommodations through a series of well-defined steps. Have a read at the flow chart below to understand how you… - [Endpoints overview](https://docs.liteapi.travel/reference/api-endpoints-overview.md): The provided diagram visually outlines the API endpoints available in Nuitee Connect v3, categorized into four main sections: Hotel Data API, Search API, and Booking API, Loyalty API. - [OpenAPI Specifications](https://docs.liteapi.travel/reference/openapi-specifications.md): This page collects the OpenAPI specifications for all Nuitee Connect services. Use the links below to explore endpoints, schemas, and examples for each API domain. These specs are the source of truth… - [Payments & Revenue](https://docs.liteapi.travel/reference/payments.md) - [Google Hotel Center integration](https://docs.liteapi.travel/reference/google-hotel-center-integration.md) ## API Reference: AI INTEGRATIONS - [MCP Server for AI Agents](https://docs.liteapi.travel/reference/mcp-server.md): Nuitee Connect provides an **MCP (Model Context Protocol) server** that allows AI systems, agents, and LLM-based applications to securely access Nuitee Connect capabilities. - [Prompt for Vibe Coding tools](https://docs.liteapi.travel/reference/prompt-for-vibe-coding-tools.md): Nuitee Connect provides a ready-to-use script designed specifically for vibe coding tools like Cursor and Lovable. - [Booking Assistant AI Chatbot](https://docs.liteapi.travel/reference/liteapi-ai-chatbot.md): The Nuitee Connect AI Chatbot is a ready-to-embed chat widget that gives your users a natural language interface for finding and booking hotels. ## API Reference: API: Search - [Retrieve rates for hotels](https://docs.liteapi.travel/reference/post_hotels-rates.md): ## Overview Search for hotel rates and availability across multiple hotels. This is your primary endpoint for finding bookable hotel rooms with real-time pricing. ## When to Use - **Display hotel… - [Retrieve minimum rate for hotels](https://docs.liteapi.travel/reference/post_hotels-min-rates.md): ## Overview Get the cheapest available rate for each hotel in your list. Perfect for displaying price comparisons without loading full rate details. ## When to Use - **Show price ranges** on hotel… ## API Reference: API: Booking - [1. Create a checkout session (PREBOOK)](https://docs.liteapi.travel/reference/post_rates-prebook.md): ## Overview **Step 1 of 2** in the booking flow. Create a prebook session to check the availability of a rate and get final pricing before payment. This `prebookId` needed to complete the booking.… - [2. Complete a booking](https://docs.liteapi.travel/reference/post_rates-book.md): ## Overview **Step 2 of 2** in the booking flow. Complete the booking by providing guest information and payment details. This confirms the reservation and creates the final booking. ## When to Use… - [Retrieve a prebook by ID](https://docs.liteapi.travel/reference/get_prebooks-prebookid.md): ## Overview Retrieve details of an existing prebook session by its ID. Use this to fetch prebook information without creating a new session. ## When to Use - **Session recovery** - Retrieve… - [List bookings](https://docs.liteapi.travel/reference/listbookings.md): ## Overview Search for bookings by guest ID or client reference. Perfect for displaying a guest's booking history or finding bookings by your internal reference codes. ## When to Use - **Guest… - [Retrieve a booking](https://docs.liteapi.travel/reference/get_bookings-bookingid.md): ## 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 -… - [Cancel a booking](https://docs.liteapi.travel/reference/put_bookings-bookingid.md): ## Overview Cancel an existing confirmed booking. Cancellation policies determine whether a full refund, partial refund, or charges apply. ## When to Use - **Guest cancellation** - Allow guests to… - [Retrieve all bookings](https://docs.liteapi.travel/reference/get_bookings.md): ## 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… - [Amend guest name on a booking](https://docs.liteapi.travel/reference/put_bookings-bookingid-amend.md): ## Overview Update guest information (name and email) for an existing booking. Useful for correcting typos or updating guest details after booking. ## When to Use - **Name corrections** - Fix… - [Amend booking checkin, checkout or occupancies](https://docs.liteapi.travel/reference/post_bookings-bookingid-alternative-prebooks.md): ## Overview **Hard Amendment** — Search for alternative rates at the same hotel and create ready-to-book prebook sessions for a confirmed booking. Used when the guest needs to change their… - [Complete a hard amendment (rebook)](https://docs.liteapi.travel/reference/post_rates-rebook.md): ## Overview **Step 2 of 2** in the **hard amendment** flow. Use a `prebookId` produced by `POST /bookings/{bookingId}/alternative-prebooks` to create the replacement booking. On success, the new… ## API Reference: API: Hotel data - [Retrieve a list of hotels](https://docs.liteapi.travel/reference/get_data-hotels.md): ## Overview Search and retrieve hotel listings based on various criteria. Get hotel metadata including names, addresses, ratings, amenities, and images for display in your application. ## When to… - [Get the details of a hotel](https://docs.liteapi.travel/reference/get_data-hotel.md): ## Overview Get comprehensive details about a specific hotel including descriptions, amenities, images, location, and ratings. Perfect for displaying hotel detail pages. ## When to Use - **Hotel… - [Get the reviews of a hotel](https://docs.liteapi.travel/reference/get_data-reviews.md): ## Overview Retrieve guest reviews and ratings for a specific hotel. Display authentic feedback from previous guests to help users make informed booking decisions. ## When to Use - **Review… - [Search hotel rooms by image and text (Beta)](https://docs.liteapi.travel/reference/get_data-hotels-room-search.md): ## Overview **Beta Feature** - Search hotel rooms using visual and text-based queries. Uses image search technology to match your query against room images and find hotels with rooms that match your… - [Search hotels by semantic query (Beta)](https://docs.liteapi.travel/reference/get_data-hotels-semantic-search.md): ## Overview **Beta Feature** - Search hotels using natural language queries. Uses AI to understand search intent and find hotels that match the meaning, not just keywords. ## When to Use -… - [Ask a question about a hotel (Beta)](https://docs.liteapi.travel/reference/get_data-hotel-ask.md): ## Overview **Beta Feature** - Ask natural language questions about a specific hotel and get AI-powered answers based on the hotel's information. ## When to Use - **Hotel Q&A** - Answer customer… - [Generate hotel highlights (Beta)](https://docs.liteapi.travel/reference/post_data-hotel-highlights.md): ## Overview **Beta Feature** - Generate short, AI-written "Smart Highlight" cards for a hotel. Each highlight is a title plus a one or two sentence description, generated directly in the requested… - [Get the normalized tax schema of a hotel](https://docs.liteapi.travel/reference/gethoteltaxschema.md): ## Overview Returns the tax schema of a hotel as normalized static data, independent of the supply provider the rules were learned from. Each entry describes one tax or fee: whether it is already… - [Search for a list of places](https://docs.liteapi.travel/reference/get_data-places.md): ## Overview Search for places, locations, and areas using Google Places API. Returns a list of matching places that can be used to search for hotels within specific boundaries. **Pricing**: $0.01… - [Search for a specific place](https://docs.liteapi.travel/reference/get_data-places-placeid.md): ## Overview Get detailed information about a specific place using its Place ID. Returns complete place details including boundaries and location information. **Pricing**: $0.01 per request ## When… - [List the cities of a country](https://docs.liteapi.travel/reference/get_data-cities.md): ## Overview Get a list of all cities within a specific country. Perfect for building location dropdowns and city selection interfaces. ## When to Use - **City dropdowns** - Populate city selection… - [List all countries](https://docs.liteapi.travel/reference/get_data-countries.md): ## Overview Get a complete list of all countries available in the system with their ISO-2 country codes. Essential for building country selection interfaces. ## When to Use - **Country dropdowns**… - [List all currencies](https://docs.liteapi.travel/reference/get_data-currencies.md): ## Overview Get all available currencies with their codes, names, and the countries where each currency is used. Perfect for building currency selection interfaces. ## When to Use - **Currency… - [List the IATA codes](https://docs.liteapi.travel/reference/get_data-iatacodes.md): ## Overview Get IATA (International Air Transport Association) airport codes with airport names, coordinates, and country information. Useful for airport-based hotel searches. ## When to Use -… - [List Hotel Facilities with Multi-Language Support](https://docs.liteapi.travel/reference/get_data-facilities.md): ## Overview Get all available hotel facilities (amenities) with multi-language translations. Use these facility IDs to filter hotel searches by amenities. ## When to Use - **Facility filters** -… - [List of hotel types](https://docs.liteapi.travel/reference/get_data-hoteltypes.md): ## Overview Get all available hotel type classifications (e.g., resort, boutique, business hotel). Use type IDs to filter hotel searches. ## When to Use - **Type filters** - Filter hotels by type… - [List of hotel chains](https://docs.liteapi.travel/reference/get_data-chains.md): ## Overview Get all available hotel chains (e.g., Marriott, Hilton, IHG). Use chain IDs to filter hotel searches by brand. ## When to Use - **Chain filters** - Filter hotels by chain/brand -… - [List of supported languages](https://docs.liteapi.travel/reference/get_data-languages.md): ## Overview Get all supported languages for hotel translations and content localization. Use language codes to request hotel data in specific languages. ## When to Use - **Language selection** -… - [Get weather data](https://docs.liteapi.travel/reference/get_data-weather-1.md): ## Overview Get weather forecasts for specific locations. Response structure adapts based on the forecast time range (short-term vs. long-term). ## When to Use - **Travel planning** - Show weather… ## API Reference: API: Vouchers - [Create a new voucher](https://docs.liteapi.travel/reference/post_vouchers.md): ## Overview Create discount vouchers that customers can apply to their hotel and flight bookings. Supports percentage discounts, fixed amounts, and points redemption vouchers. ## When to Use -… - [Retrieve all vouchers](https://docs.liteapi.travel/reference/get_vouchers.md): ## Overview Get a paginated list of all vouchers in your system, including active and inactive vouchers with their current status. ## When to Use - **Voucher management** - View all vouchers in… - [Retrieve a specific voucher](https://docs.liteapi.travel/reference/get_vouchers-voucherid.md): ## Overview Get complete details for a specific voucher by its ID, including discount rules, validity, and usage information. ## When to Use - **Voucher lookup** - Find details for a specific… - [Update a voucher](https://docs.liteapi.travel/reference/put_vouchers-id.md): ## Overview Modify an existing voucher's settings, including discount values, validity periods, usage limits, and status. ## When to Use - **Extend validity** - Update voucher end dates - **Adjust… - [Update voucher status](https://docs.liteapi.travel/reference/put_vouchers-id-status.md): ## Overview Quickly activate or deactivate a voucher without updating other fields. Perfect for temporarily disabling vouchers. ## When to Use - **Temporary disable** - Deactivate vouchers without… - [Retrieve voucher usage history](https://docs.liteapi.travel/reference/get_vouchers-history.md): ## Overview Get a complete history of all voucher redemptions across your system, showing which vouchers were used, when, and for which bookings. ## When to Use - **Usage analytics** - Track… - [Delete a voucher](https://docs.liteapi.travel/reference/delete-voucher.md): ## Overview Permanently remove a voucher from your system. Use with caution - deleted vouchers cannot be recovered. ## When to Use - **Cleanup** - Remove expired or unused vouchers - **Error… ## API Reference: API: Price Index - [Get aggregated price index for a city](https://docs.liteapi.travel/reference/getpriceindexcity.md): ## Overview Retrieve aggregated historical price index data for all hotels in a specific city. Returns average per-night prices aggregated by calendar day across all hotels in the city, providing… - [Get price index for hotels](https://docs.liteapi.travel/reference/getpriceindexhotels.md): ## Overview Retrieve historical price index data for a list of hotels. Returns average per-night prices aggregated by calendar day, allowing you to analyze pricing trends and patterns. **⚠️ Beta… - [Get cached public price for a hotel](https://docs.liteapi.travel/reference/getpublicprice.md): ## Overview Retrieve cached public price data for a specific hotel and occupancy. This endpoint returns pricing information sourced from public booking platforms (e.g., Booking.com, Expedia) that… ## API Reference: API: Analytics - [Retrieve weekly analytics](https://docs.liteapi.travel/reference/post_analytics-weekly.md): ## Overview Get weekly aggregated sales and booking data broken down by week. Perfect for tracking week-over-week performance trends. ## When to Use - **Weekly performance dashboards** - Show… - [Retrieve detailed analytics report](https://docs.liteapi.travel/reference/post_analytics-report.md): ## Overview Get comprehensive analytics covering sales, bookings, commissions, and revenue for your date range. This is your complete business intelligence endpoint. ## When to Use - **Executive… - [Retrieve market analytics](https://docs.liteapi.travel/reference/post_analytics-markets.md): ## Overview Analyze your bookings and sales by customer nationality/market. Understand which countries drive the most business. ## When to Use - **Market analysis** - Identify top-performing… - [Most booked hotels](https://docs.liteapi.travel/reference/post_analytics-hotels.md): ## Overview Get a ranked list of your top-performing hotels by booking volume and sales. Perfect for identifying your best-selling properties. ## When to Use - **Hotel performance dashboards** -… - [Commission earnings report](https://docs.liteapi.travel/reference/post_commissions-report.md): ## Overview Returns commission earnings on the account for the given date range. Each day in the range includes the total commission amount and the average commission percentage. ## When to Use -… - [Guest nationality (source market) report](https://docs.liteapi.travel/reference/get_bookings-guest-nationality-report.md): ## Overview Returns analytics on the source markets (guest nationality) of bookings. Compares the current period to the previous period of equal length, with per-nationality booking counts, sales in… - [Destinations report (by destination country)](https://docs.liteapi.travel/reference/get_bookings-source-markets-report.md): ## Overview Returns analytics on **destinations** (the country where the hotel is located). Compares the current period to the previous period of equal length, with per-destination booking count,… - [Properties (hotels) sales report](https://docs.liteapi.travel/reference/get_bookings-hotels-sales-report.md): ## Overview Returns analytics on **properties** (hotels): per-hotel sales, buying price, profit, and profit margin. Compares the current period to the previous period of equal length. Results are… - [Search bookings by text](https://docs.liteapi.travel/reference/searchbookings.md): ## Overview Search for bookings by free-text query. Matches guest names, booking IDs, hotel names, and other booking-related fields. Results are paginated. ## When to Use - **Admin or support… ## API Reference: API: Loyalty - [Fetch all guests](https://docs.liteapi.travel/reference/get_guests.md): ## Overview Retrieve a complete list of all guests enrolled in your loyalty program with their points balance and booking history. ## When to Use - **Guest management** - View all loyalty program… - [Fetch a specific guest](https://docs.liteapi.travel/reference/get_guests-guestid.md): ## Overview Get detailed information about a specific guest by their ID, including loyalty points and booking history. ## When to Use - **Customer profiles** - Display guest information on their… - [Fetch a guest's bookings](https://docs.liteapi.travel/reference/get_guests-guestid-bookings.md): ## Overview Get all loyalty transactions for a specific guest, showing points earned and cashback rates used for each booking. ## When to Use - **Points history** - Show guests their points… - [Fetch a guest's vouchers](https://docs.liteapi.travel/reference/get_guests-guestid-vouchers.md): ## Overview Retrieve all vouchers available to a specific guest, including discount codes, validity periods, and usage limits. ## When to Use - **Voucher display** - Show available vouchers on a… - [Update the loyalty program](https://docs.liteapi.travel/reference/put_loyalties.md): ## Overview Configure your loyalty program settings, including enabling/disabling the program and setting cashback rates. ## When to Use - **Program activation** - Enable or disable your loyalty… - [Get the loyalty program settings](https://docs.liteapi.travel/reference/get_loyalties.md): ## Overview Retrieve your current loyalty program configuration, including whether it's active and what cashback rate is set. ## When to Use - **Settings display** - Show current program… - [Fetch a guest's loyalty points](https://docs.liteapi.travel/reference/get_guests-guestid-loyalty-points.md): ## Overview Get a guest's current available points and upcoming points (points pending from confirmed bookings). ## When to Use - **Points display** - Show points balance on guest account pages -… - [Redeem a guest's loyalty points](https://docs.liteapi.travel/reference/post_guests-guestid-loyalty-points-redeem.md): ## Overview Convert a guest's loyalty points into a discount voucher. Points are converted at a rate of **10 points = $1 USD** (or equivalent in the specified currency). ## When to Use - **Points… ## API Reference: API: Supply Customization - [Retrieve supply customization settings](https://docs.liteapi.travel/reference/get_supply-customization.md): ## Overview Get your current supply customization preferences, including advanced accessibility options for hotel searches. ## When to Use - **Settings display** - Show current customization… - [Update supply customization settings](https://docs.liteapi.travel/reference/put_supply-customization.md): ## Overview Configure your supply customization preferences, including enabling or disabling advanced accessibility options for hotel searches. ## When to Use - **Enable features** - Turn on… ## API Reference: API: Flights - [Get airline by IATA code](https://docs.liteapi.travel/reference/get_data-flights-airlines-iatas-iatacode.md): ## Overview Retrieve full details for a specific airline using its 2-letter IATA code. ## When to Use - **Airline display** - Show airline name, logo, and alliance for a given IATA code - **Flight… - [List airlines](https://docs.liteapi.travel/reference/get_data-flights-airlines.md): ## Overview Retrieve a list of airlines with optional filtering by name, alliance, and active status. ## When to Use - **Airline directory** - Build a searchable list of airlines for display or… - [List airline IATA codes](https://docs.liteapi.travel/reference/get_data-flights-airlines-iatas.md): ## Overview Retrieve a lightweight list of airline IATA codes with names for autocomplete and lookup purposes. ## When to Use - **Autocomplete dropdowns** - Populate airline search inputs with a… - [Get airport by IATA code](https://docs.liteapi.travel/reference/get_data-flights-airports-iatas-iatacode.md): ## Overview Retrieve detailed information for a specific airport using its 3-letter IATA code. ## When to Use - **Airport display** - Show airport name, city, and country for a given IATA code -… - [List airport IATA codes](https://docs.liteapi.travel/reference/get_data-flights-airports-iatas.md): ## Overview Retrieve a lightweight list of airport IATA codes with names for autocomplete and lookup purposes. ## When to Use - **Autocomplete dropdowns** - Populate airport search inputs with a… - [Search airports](https://docs.liteapi.travel/reference/get_data-flights-airports.md): ## Overview Search for airports by name, city, or IATA code using a text query. Returns matching airports for use in autocomplete and search inputs. ## When to Use - **Airport autocomplete** -… - [Search for flights (legs-based itinerary)](https://docs.liteapi.travel/reference/post_flights-rates.md): ## Overview Search for available flights with real-time pricing from multiple providers. The itinerary **must** be sent as a non-empty `legs` array. Each leg follows the provider **SearchLeg**… - [Verify flight offer](https://docs.liteapi.travel/reference/post_flights-verify.md): ## Overview Confirm a flight offer is still available and retrieve the latest pricing before proceeding to booking. Always verify before prebooking to avoid price discrepancies. ## When to Use -… - [Flexible-date price matrix (one-way or round-trip)](https://docs.liteapi.travel/reference/searchflightsmatrix.md): ## Overview Search the cheapest fare for each departure (and, on round-trips, return) date combination across a grid of nearby dates — `±flexDays` around the dates in your request. Accepts the same… - [1. Create a checkout session (PREBOOK)](https://docs.liteapi.travel/reference/post_flights-prebooks.md): ## Overview Initiate a flight booking session by reserving the offer with the provider, creating a payment intent when you use the Stripe SDK, and discovering available ancillary services — all in a… - [1.2 Attach services to prebook (Optional)](https://docs.liteapi.travel/reference/post_flights-prebooks-prebookid-services.md): ## Overview Add ancillary services such as seat selection or extra baggage to an existing prebook before confirming the final booking. ## When to Use - **Seat selection** - Allow users to choose… - [1.3 Get prebook details (optional)](https://docs.liteapi.travel/reference/getflightprebook.md): ## Overview Retrieve an existing flight checkout session (prebook) by ID, including any ancillary services already attached and a live catalog of remaining attachable services. ## When to Use -… - [2. Complete a booking](https://docs.liteapi.travel/reference/post_flights-bookings.md): ## Overview Complete a flight reservation by confirming a prebook and processing payment. This is the final step in the booking flow. ## When to Use - **Final booking confirmation** - Convert a… - [Get booking details](https://docs.liteapi.travel/reference/get_flights-bookings-bookingid.md): ## Overview Retrieve complete details of a confirmed flight booking using its unique booking ID. ## When to Use - **Booking confirmation page** - Display full itinerary after booking completes -… - [List bookings](https://docs.liteapi.travel/reference/get_flights-bookings.md): ## Overview List confirmed flight bookings owned by the authenticated user. Supports an optional PNR + last-name lookup for retrieving a single booking. ## When to Use - **"My bookings" page** -… - [Get cancellation quote](https://docs.liteapi.travel/reference/get_flights-bookings-bookingid-cancellations.md): ## Overview Returns refund eligibility, estimated refund amounts, and penalty details for a booking **without actually cancelling it**. Use this before calling `POST… - [Cancel a booking](https://docs.liteapi.travel/reference/post_flights-bookings-bookingid-cancellations.md): ## Overview **Cancels a flight booking.** Submits cancellation for an existing booking and returns the cancellation outcome. Call `GET /flights/bookings/{bookingId}/cancellations` first to preview… - [Get booking services](https://docs.liteapi.travel/reference/get_flights-bookings-bookingid-services.md): ## Overview Retrieve the ancillary services (seats, baggage) for an existing flight booking: services that are **already booked** together with the live catalog of services that **can still be… - [Precharge extra charges on a booking](https://docs.liteapi.travel/reference/prechargeflightextracharges.md): ## Overview Creates a pending post-booking extra-charge batch for an existing flight booking and returns an opaque `chargesId`. For Stripe-paid bookings, also creates a PaymentIntent… - [Confirm extra charges on a booking](https://docs.liteapi.travel/reference/chargeflightextracharges.md): ## Overview Confirms a pending extra-charge batch created by `/extra-charges/precharges`. Captures the Stripe PaymentIntent or bills the credit line, then appends the lines to the booking. ##… ## API Reference: API: Mapping - [List partners available for hotel ID mapping](https://docs.liteapi.travel/reference/get_hotels-match-partners-1.md): ## Overview Returns every partner that can be used for hotel ID mapping, along with each partner's inventory coverage size (`mappings`). Use this list to discover which partner inventories can be… - [Map partner hotel IDs to Nuitee inventory](https://docs.liteapi.travel/reference/post_hotels-match-partners-with-id-1.md): ## Overview Maps a specific partner's hotel inventory to Nuitee / liteAPI catalogue IDs. Upload a CSV of partner hotel IDs and receive a result CSV that links each row to Nuitee property… - [Match supplier rooms to a reference catalog](https://docs.liteapi.travel/reference/post_rooms-match-1.md): ## Overview Match supplier room names to your reference catalog. For each supplier room, returns the best matching reference room along with ranked alternatives and confidence scores. ## When to… - [Submit an async room mapping job](https://docs.liteapi.travel/reference/post_rooms-match-async-1.md): ## Overview Submit an async room mapping job for a hotel. The job processes in the background and produces high-quality mappings with detailed reasoning for each decision. Only one job per hotel can… - [Get async room mapping job status](https://docs.liteapi.travel/reference/get_rooms-match-async-jobs-jobid-1.md): ## Overview Check the status of an async room mapping job and retrieve results. Returns full job details including per-room decisions when complete. Jobs expire 24 hours after completion. ## When… - [Get saved room mappings for a hotel](https://docs.liteapi.travel/reference/get_rooms-match-async-matches-hotelid-1.md): ## Overview Retrieve all saved room mappings for a hotel. Returns the current mapping cache without job details or audit trail. ## When to Use - **Lookup existing mappings** - Check what mappings… - [Group rooms without a reference catalog](https://docs.liteapi.travel/reference/post_rooms-group-1.md): ## Overview Group similar room listings for a property without needing a reference catalog. Automatically clusters rooms based on attributes like room class, bed type, and view. ## When to Use -… - [Group rooms into reference buckets](https://docs.liteapi.travel/reference/post_rooms-group-with-reference-1.md): ## Overview Assign supplier rooms to reference room buckets. Each supplier room is placed under its best-matching reference room (exclusive assignment - one group per supplier). ## When to Use -… ## API Reference: API: eSIMply - [List eSIMply destinations](https://docs.liteapi.travel/reference/getesimplydestinations.md): ## Overview Retrieve the list of countries and regions where eSIM data packages are available. Use this as the entry point for destination pickers in your app or website. ## When to Use -… - [List packages for a destination](https://docs.liteapi.travel/reference/getesimplypackagesbydestination.md): ## Overview Retrieve available eSIM data packages for a specific destination, including data size, validity, and pricing. ## When to Use - **Package selection UI** - Show travelers the plans… - [Create an eSIMply cart](https://docs.liteapi.travel/reference/createesimplycart.md): ## Overview Initialize a shopping cart for a selected eSIM package and travel dates. The returned `cartKey` is required to submit the purchase. ## When to Use - **Start checkout** - After the… - [Submit an eSIMply order](https://docs.liteapi.travel/reference/submitesimplyorder.md): ## Overview Finalize a cart and provision the eSIM. On success you receive the order ID, ICCID, QR / LPA install payload, and purchase details. Successful orders are persisted for the partner… - [List eSIMply orders](https://docs.liteapi.travel/reference/getesimplyorders.md): ## Overview Retrieve eSIM order history for the authenticated partner account, with optional filters for destination, date range, and client reference. ## When to Use - **Partner dashboard** -… - [List top-ups for an eSIM](https://docs.liteapi.travel/reference/getesimplytopups.md): ## Overview Retrieve top-up packages that can be applied to an existing eSIM identified by ICCID. ## When to Use - **Top-up UI** - Show add-on data packs for a traveler's active eSIM - **Upsell… - [Submit an eSIMply top-up](https://docs.liteapi.travel/reference/submitesimplytopup.md): ## Overview Apply a top-up package to an existing eSIM in a single request. On success you receive an order response with updated purchase details. Successful top-ups are persisted for the partner… - [Get an eSIMply order by ICCID](https://docs.liteapi.travel/reference/getesimplyorderbyiccid.md): ## Overview Retrieve a single eSIM order (purchase details, install metadata, and plan status) using its ICCID. ## When to Use - **Order detail page** - Show one eSIM's package, pricing, and QR… - [Get eSIM data usage by ICCID](https://docs.liteapi.travel/reference/getesimplydatausagebyiccid.md): ## Overview Retrieve live data usage for an eSIM: remaining allowance, total allowance, expiry, and status. ## When to Use - **Usage meters** - Show travelers how much data remains - **Top-up… ## API Reference: RESOURCES - [Rate Limiting](https://docs.liteapi.travel/reference/rate-limiting.md): To ensure fair use of resources, Nuitee Connect enforces rate limits on API requests. If you exceed the rate limits, you will receive a "429 Too Many Requests" response. - [Error handling](https://docs.liteapi.travel/reference/error-handling.md): Nuitee Connect uses standard HTTP status codes to indicate the success or failure of an API request. - [SDKs](https://docs.liteapi.travel/reference/sdks.md): Install a Nuitee Connect SDK, pass your API key, and call search, prebook, and book without hand-rolling every HTTP request. - [Node.JS](https://docs.liteapi.travel/reference/nodejs-sdk.md): This guide will help you get started with integrating the Nuitee Connect SDK into your Node.js application. - [Python](https://docs.liteapi.travel/reference/python.md) ## API Reference: MISC - [API Errors for booking workflow](https://docs.liteapi.travel/reference/api-errors-for-hotel-booking-workflow.md): Error codes returned by the hotel booking flow: search rates, prebook, and book. - [Languages for content](https://docs.liteapi.travel/reference/languages-for-content.md): https://docs.liteapi.travel/reference/get_data-languages - [Currencies](https://docs.liteapi.travel/reference/currencies-1.md): https://docs.liteapi.travel/reference/get_data-currencies - [Room Views](https://docs.liteapi.travel/reference/room-views.md) - [Room Amenities](https://docs.liteapi.travel/reference/room-amenities.md) - [Get weather data](https://docs.liteapi.travel/reference/get_data-weather.md): ## Overview Get weather forecasts for specific locations. Response structure adapts based on the forecast time range (short-term vs. long-term). ## When to Use - **Travel planning** - Show weather… ## Pages - [Postman collection for Nuitee Connect v3](https://docs.liteapi.travel/page/postman-collection.md)