io.github.negm17111995/maqami-travel

## 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 listings** with prices on your search results page - **Show detailed rate options** for specific hot…

## 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 listing pages - **Quick price comparisons** across multiple hotels - **Optimize performance** when…

## 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 prebook details if you've stored the prebookId - **Status checks** - Verify prebook session details before…

## 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. ## When to Use - **Before payment** - Always call this before completing a booking - **Rate confirm…

## 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 - **After prebook** - Call this after creating a prebook session - **Payment processing** - Submit…

## 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 booking is created **and the original booking is automatically cancelled** — you do **not** need to cal…

## 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 booking history** - Show all bookings for a specific guest - **Reference lookup** - Find bookings by yo…

## 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 bo…

## 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 cancel their bookings - **Administrative cancellation** - Cancel bookings from admin panels - **Pol…

## 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…

## 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 typos in guest names - **Email updates** - Update guest email addresses - **Guest changes** - Change gue…

## 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 check-in/check-out dates or room occupancy. ## When to Use - **Date changes** — Guest needs different check…

## 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 - **Promotional campaigns** - Create discount codes for marketing - **Customer rewards** - Generate vouch…

## 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 your admin panel - **Inventory overview** - See all available discount codes - **Status monitoring** -…

## 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 voucher code - **Validation** - Verify voucher details before applying to bookings - **Details display**…

## 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 discounts** - Change discount values or types - **Update limits** - Modify usage limits or minimum…

## Overview Quickly activate or deactivate a voucher without updating other fields. Perfect for temporarily disabling vouchers. ## When to Use - **Temporary disable** - Deactivate vouchers without deleting them - **Reactivate vouchers** - Turn inactive vouchers back on - **Status management** -…

## 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 voucher redemption patterns - **Performance reporting** - See which vouchers are most popular - **Audit t…

No se publicó ningún esquema de entrada para esta herramienta.

## 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 sales trends by week - **Week-over-week comparisons** - Identify growth patterns - **Business reporting*…

## 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 dashboards** - Complete business overview - **Financial reporting** - Track revenue, sales, and commi…

## 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 markets - **Geographic insights** - Understand customer distribution - **Marketing optimization** - Focus…

## 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** - Show top hotels by bookings - **Sales analysis** - Identify highest-revenue properties - **Inventory…

## 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 - **Commission tracking** - Monitor daily commission earnings - **Revenue analysis** - Understand comm…

## 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 USD, average booking value, and period-over-period change. ## When to Use - **Source market analy…

## 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, hotel count, sales in USD, average booking value, and period-over-period change. ## When to Use - **…

## 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 ordered by current-period sales (highest first) and limited by the `limit` parameter. ## When to Use…

## 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 lookup** - Find bookings by guest name, hotel name, or partial ID - **Text search** - Search across mult…

## 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 included in the room rate, whether it is a percentage of the rate or a fixed amount, and how fixed amo…

## 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 per request ## When to Use - **Location autocomplete** - Build location search with autocomplete su…

## 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 to Use - **Place details** - Get full information about a selected place - **Boundary information*…

## 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 Use - **Hotel listings** - Display hotel search results - **Location-based search** - Find hotels by…

## 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 - **Natural language search** - Let users search with phrases like "romantic getaway in London" - **Intent-ba…

## 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 questions about hotels - **Information lookup** - Get specific details about amenities, services, or…

## 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 language. **Rate Limiting**: This endpoint is rate-limited to **10 requests per minute** per API key…

## 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 visual preferences, amenities, or style. ## When to Use - **Visual room search** - Find rooms bas…

## 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 detail pages** - Show complete hotel information - **Booking pages** - Display hotel details before b…

## 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 display** - Show guest reviews on hotel detail pages - **Rating aggregation** - Display average ratings an…

## 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 lists - **Location filters** - Filter hotels by city - **Geographic data** - Get city lists for spe…

## 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** - Populate country selection lists - **Location filters** - Filter hotels or searches by country -…

## 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 dropdowns** - Populate currency selection lists - **Price display** - Show prices in different currenci…

## 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 - **Airport searches** - Find hotels near airports - **Location selection** - Let users search by airport…

## 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** - Build amenity filtering in hotel searches - **Facility display** - Show available facilities with tra…

No se publicó ningún esquema de entrada para esta herramienta.

## 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 in search - **Type display** - Show hotel type classifications - **Reference data** - Get hotel type…

No se publicó ningún esquema de entrada para esta herramienta.

## 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 - **Brand selection** - Let users search for specific hotel chains - **Reference data** - Get chain IDs for…

No se publicó ningún esquema de entrada para esta herramienta.

## 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** - Display available languages to users - **Content localization** - Get language codes for API requests…

No se publicó ningún esquema de entrada para esta herramienta.

## 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 forecasts for destinations - **Hotel pages** - Display weather information on hotel detail pages -…

Search for a hotel using a semantic text query. Returns the best-matching hotel with basic details and a relevance score.

## 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 members - **Points administration** - Check points balances across all guests - **Customer support**…

No se publicó ningún esquema de entrada para esta herramienta.

## 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 account page - **Points lookup** - Check a specific guest's points balance - **Booking history** - Sh…

## 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 earning history - **Transaction details** - Display detailed booking transactions - **Cashback tracking**…

## 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 guest's account page - **Discount management** - Check which vouchers a guest can use - **Validity ch…

## 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 program - **Rate adjustments** - Update cashback percentages - **Program management** - Change loyalt…

## 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 configuration in admin panels - **Status checks** - Verify if the loyalty program is enabled - **Rate verific…

No se publicó ningún esquema de entrada para esta herramienta.

## 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 - **Points checking** - Quick lookup of available points - **Pending points** - Display points that wi…

## 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 redemption** - Allow guests to convert points to vouchers - **Reward fulfillment** - Create discount…

## Overview Get your current supply customization preferences, including advanced accessibility options for hotel searches. ## When to Use - **Settings display** - Show current customization settings in admin panels - **Configuration checks** - Verify your current preferences - **Feature verific…

No se publicó ningún esquema de entrada para esta herramienta.

## Overview Configure your supply customization preferences, including enabling or disabling advanced accessibility options for hotel searches. ## When to Use - **Enable features** - Turn on advanced accessibility filtering - **Customize supply** - Adjust how hotel results are filtered - **Acces…

## 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 city-level pricing trends. **⚠️ Beta Feature**: This endpoint is currently in beta. The API structure…

## 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 Feature**: This endpoint is currently in beta. The API structure and behavior may change in future ver…

## 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 has been pre-fetched and cached. It applies occupancy canonicalization automatically, so callers don't…

## 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 result enrichment** - Fetch airline details to display alongside search results - **Data validation…

## 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 - **Flight result enrichment** - Fetch airport details to display alongside origin/destination in searc…

## 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 full list of codes and names - **Client-side filtering** - Download the full list once and filter loc…

## 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** shape: required `origin`, `destination`, and `date` (YYYY-MM-DD); optional `direction` (`OUTBOUND` or `IN…

## 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 `legs`-based body as `POST /flights/rates` plus optional `flexDays` (1–3, default 3). **Supported:*…

## 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 - **Pre-booking validation** - Confirm offer availability after user selects a flight - **Price confirm…

## 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 - **Resume checkout** — Reload prebook state after the user navigates away - **Confirm attached ancillar…

## 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 specific seats after prebook - **Extra baggage** - Let users add additional luggage allowance - **Pri…

## 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 - **Booking management** - Retrieve details for an existing reservation - **Itinerary display** - Show…

## Overview Returns refund eligibility, estimated refund amounts, and penalty details for a booking **without actually cancelling it**. Use this before calling `POST /flights/bookings/{bookingId}/cancellations` to understand the financial impact of cancellation. ## When to Use - **Pre-cancellati…

## 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 the financial impact without committing. If cancellation is accepted but not yet confirmed, this end…

## 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 filtering - **Alliance filtering** - Filter airlines by alliance membership (Star Alliance, oneworld,…

## 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 minimal list - **Client-side filtering** - Download the full list once and filter locally - **Code va…

## 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** - Power origin/destination search inputs with type-ahead suggestions - **Airport discovery** - Find airpo…

## 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** - Display the authenticated user's confirmed flight bookings - **PNR lookup** - Retrieve a single booki…

## 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 prebook into a confirmed booking - **Payment completion** - Confirm with Stripe (`TRANSACTION_ID`) or…

## 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 single request. ## When to Use - **Start the booking flow** once a user has confirmed their fligh…

## Overview Search available tours and activities with localized content and prices in your chosen currency. ## When to Use - **Search results** - Populate a tours listing or map view - **Destination pages** - Show activities available in a city or region - **Category browsing** - Filter tours b…

No se publicó ningún esquema de entrada para esta herramienta.

## Overview Retrieve full details for a specific tour, including description, media, inclusions, pricing context, and structured itineraries when available. ## When to Use - **Product pages** - Display a tour detail view before the user selects dates - **Comparison** - Show full metadata when co…

No se publicó ningún esquema de entrada para esta herramienta.

## Overview Retrieve available dates and time slots for a specific tour so users can pick when to attend. ## When to Use - **Date pickers** - Populate a calendar or slot selector on the tour page - **Availability checks** - Confirm a tour runs on the user's travel dates - **Booking flow** - Gate…

No se publicó ningún esquema de entrada para esta herramienta.

## Overview Retrieve normalized guest reviews and ratings for a specific tour. ## When to Use - **Review sections** - Display guest feedback on tour detail pages - **Trust building** - Show authentic ratings before booking - **Decision support** - Help users evaluate tours before selecting dates…

No se publicó ningún esquema de entrada para esta herramienta.

## Overview Resolve priced booking options, time slots, and required guest inputs for a selected tour date and participant mix. ## When to Use - **Option/slot pickers** - Show available variants and start times for a date - **Live pricing** - Display authoritative slot sell totals (`pricing.tota…

## Overview Create a temporary hold on the selected tour slot and a Stripe PaymentIntent for checkout. ## When to Use - **Checkout start** — After the user picks option, slot, and participants from booking-options - **Payment setup** — Obtain `transactionId` and `secretKey` for Stripe SDK confir…

Capture Stripe payment then confirm cart with experiences-api. Cart status `completed` maps to dispatcher `PENDING_CONFIRMATION`; final `CONFIRMED` arrives via webhook. Cart status `ERROR` returns 502. Public booking responses expose partner **sell** in `price` and partner earn in `commission` / `…

Poll booking status while pending confirmation or retrieve voucher after webhook confirms. Public response omits `providerPayment` (provider retail/invoice).