# Hotel Booking API with Hotel and Room Mapping | OnArrival > Search and book hotel rates from multiple suppliers with property and room mapping, clear rate conditions and booking management. Source: https://www.onarrival.com/hotels --- # Hotel booking with property and room mapping built in. The same hotel shows up once, not five times from five suppliers. We match hotels and room types across suppliers, and keep each rate’s meal plan and cancellation terms clear, so travellers know exactly what they are paying for. [Request a key](https://www.onarrival.com/signup) [Read the docs](https://docs.onarrival.com/) properties, mapped & deduplicated 2M+ suppliers behind one integration 30+ duplicate listings, July 2026 graph <0.1% In short ## Hotels, in four steps. Many suppliers sell the same hotel under different names. We turn them into one clear listing, with every rate side by side. 1. Collect Rates arrive from 30+ suppliers, each in its own format. 2. Match Listings for the same hotel and the same room are matched into one. 3. Compare Travellers see one hotel card, with each rate’s meals and cancellation terms. 4. Book Recheck the chosen rate, then book and cancel through one API. Inventory ## Many supply pools. One catalog. Compare wholesale, hotel-direct and booking-network rates in one format. Eligibility and cancellation terms stay attached. BEDBANKS ### Bedbanks & wholesalers Bedbanks are hotel wholesalers. HotelBeds, WebBeds, TBO and RateHawk-class pools bring net rates, contracted room allocations and the long tail of independent hotels. Sub-second cache CHAIN ### Chain direct Marriott, Accor, Hilton and IHG, connected at the source. Member rates, points eligibility and points earned show inline. Loyalty-aware rates GDS ### GDS + long-stay Hotel content from the big booking networks (GDS) for corporate travel, plus serviced apartments and extended stays for trips measured in weeks. Corporate + 28-night How it works ## One property, every rate. Search groups matching supplier listings under one hotel and compares their rates. Recheck the chosen rate before booking. If the price or availability has changed, show the traveller the updated offer. [Read the reference](https://docs.onarrival.com/) Five names, one room Garden View Double HOTELBEDS $248 refundable Garden-Facing Standard WEBBEDS $252 prepay Garden Twin · Member HYATT DIRECT $240 member rate Std. Dbl, Garden TBO $256 24h cancel Dbl Garden Vw GDS $251 via LISGL Canonical room Garden View · 1 King Grand Hyatt · Dubai Best of 5 rates$240 Won byHyatt direct Loyalty-aware <0.1% DUPLICATE In depth ## Supply, mapping, rates. Hotel matching, room details and supplier rates belong together. Travellers get a clear comparison, and every offer keeps its conditions. 01 ### Hotel mapping, built in We match supplier listings to one shared hotel ID using location, address, phone and content. Three spellings of Grand Hyatt Dubai can become one hotel card with the supplier rates beneath it. Uncertain matches need review. Mapping 02 ### Room mapping, also built in Room names alone do not prove a match. We compare beds, occupancy and view. A double and a twin stay separate when their beds differ, and each rate keeps its meal plan and cancellation terms. Mapping 03 ### Rich content, normalised Photos, descriptions, amenities and accessibility details, merged from the most reliable source for each field. Amenities follow one list of 300+ types in 14 languages, and duplicate photos are removed. Content 04 ### Best-rate logic Every rate from every supplier sits on one card, ranked by total price after taxes and fees, refundability, breakfast and loyalty eligibility. Your markup rules apply on top. Pricing 05 ### Bring your own supply Direct hotel contracts and negotiated wholesale rates go through the same mapping and compete in the same ranking. They are flagged as yours and settled to you. Supply @media (prefers-reduced-motion: no-preference){ .oa-illo-in .pdh-row{transform-box:fill-box; animation:pdhPull 1.6s ease-in-out both;} .pdh-row-0{animation-delay:0s} .pdh-row-1{animation-delay:.08s} .pdh-row-2{animation-delay:.16s} .pdh-row-3{animation-delay:.24s} .pdh-row-4{animation-delay:.32s} .oa-illo-in .pdh-match{stroke-dasharray:120; stroke-dashoffset:120; animation:pdhDraw .9s .75s ease-out both;} .oa-illo-in .pdh-canon{transform-box:fill-box; transform-origin:center; animation:pdhPulse .7s 1.1s ease-out both;} .oa-illo-in .pdh-stamp{opacity:0; transform-box:fill-box; transform-origin:center; animation:pdhStamp .55s 1.45s ease-out both;} } /* opacity-only on transform-positioned groups (see pdf note above). */ @keyframes pdhPull{from{opacity:1}to{opacity:.58}} @keyframes pdhDraw{to{stroke-dashoffset:0}} @keyframes pdhPulse{0%{opacity:.55}60%{opacity:1}100%{opacity:1}} @keyframes pdhStamp{from{opacity:0}to{opacity:1}} 5 LISTINGS → 1 PROPERTYBedbank AGRD-LIS-01Chain CRSGLISBOABedbank B774-2231GDSLISGLDirectgrandlisboaGrand LisboaCANONICALROOM MATCHKing · Sea×3Twin · City×2Suite×1no double-listings<0.1% DUPLICATE RATE Capabilities ## Hotels API capabilities Supply - 30+ bedbanks & wholesalers - Chain direct (Marriott, Accor, Hilton) - Independent + boutique - GDS hotel content - Long-stay & serviced apartments Mapping - Shared property IDs - Room-level mapping - 300+ amenity types - Photo CDN + alt-text - Multilingual descriptions Pricing - Best-rate logic across suppliers - Loyalty-aware rates - Tax + fee breakdown - Cancellation terms in one format - Pay-now vs pay-at-property Booking - Group bookings (10+ rooms) - Special requests passthrough - Confirmation routing - Voucher generation - Cancellation API Why mapping matters Property mapping brings listings for the same hotel together. Room mapping then helps travellers compare like-for-like rooms, with rate conditions shown separately. — three spellings, one hotel, five rates competing on price Properties mapped2M+ Suppliers merged30+ Duplicate rate<0.1% Who it's for ## Who uses Hotels? OTA ### Travel sellers Wholesale depth and chain-direct rates in one ranking. Mapping, content and supplier contracts are already handled. EXAMPLE WORKFLOWCompare supplier rates for the same room. Loyalty ### Points & rewards Let members use points on 2M+ properties at wholesale cost while they see retail value. Member pricing shows inline. EXAMPLE WORKFLOWUse points toward an eligible hotel stay. Corporate ### Business travel Negotiated corporate rates compete with the open market on every search, with policy caps and central billing built in. EXAMPLE WORKFLOWShow negotiated rates alongside public offers. Questions ## Hotels: common questions Something we haven’t covered? [Talk to the team](https://www.onarrival.com/company#contact). We can help you work through your integration. **Does matching a room also match its rate conditions?** No. Room identity and rate conditions are separate. Rates for the same room can differ in meals, cancellation penalties, payment timing and occupancy conditions. Compare those terms alongside the price before booking. **Is hotel and room mapping an extra product or fee?** Property and room mapping are included in the Hotels catalog. If you want to map your own inventory without using our booking API, the standalone Mapping service has its own commercial terms. **How fresh are rates and availability?** Search uses supplier availability and caching where appropriate. Recheck the selected rate before booking, because prices, rooms and cancellation conditions can change before confirmation. **Can I use my own direct hotel contracts?** Yes. Upload contracted rates or connect your extranet (the portal where your contracted hotels load their rates). They go through the same mapping and compete in the best-rate ranking, flagged as your own supply. **How do cancellations and refunds work across suppliers?** Use one cancellation API, with the supplier’s penalty schedule attached to the rate. Check the current cancellation quote before confirming, and track the refund separately until the money is returned. **What about content quality: photos, amenities, descriptions?** Each field comes from the most reliable source. Chain-direct descriptions beat short wholesaler descriptions, high-resolution photos replace duplicate thumbnails, and amenities map to a list of 300+ types in 14 languages. Pairs well with ## Build the rest of the trip. [Product Flights Search, book and manage flights through one API.](https://www.onarrival.com/flights) [Product Experiences Search and book tours, activities and attraction tickets.](https://www.onarrival.com/experiences) [Product Bundles Book flights, hotels and activities as one trip.](https://www.onarrival.com/bundles) ## Related reading [All field notes →](https://www.onarrival.com/blog) [Data and supply · 11 min How we built our hotel and room mapping pipeline Our mapping pipeline compares supplier records, checks room attributes and sends uncertain matches for review. The key is keeping the evidence behind each decision. **Pranav Upadhyay**](https://www.onarrival.com/blog/how-we-solved-room-mapping) [Data and supply · 11 min Hotel mapping: why one property appears five times Different suppliers can list the same hotel under different names. Hotel mapping joins those records while keeping room types, rate conditions and booking references distinct. **Pranav Upadhyay**](https://www.onarrival.com/blog/hotel-mapping-deduplication) [Product engineering · 11 min The travel order lifecycle: from search to refund settlement A travel order records the offer, confirmation, booking changes and related payments. Keeping that history together makes partial cancellations and delayed refunds easier to handle. **Manan Vaghasiya**](https://www.onarrival.com/blog/travel-order-lifecycle) Start building Try Hotels with sandbox access. [Request a key](https://www.onarrival.com/signup) [Read the docs](https://docs.onarrival.com/)