Hotel-API
Zoek in 1.5M+ accommodaties op stadscode (IATA-stijl, bijv. DXB) of op de hotelcodes die u uit onze catalogus opslaat, lees tarieven per kamer met verzorgingsniveau en annuleringsvoorwaarden, valideer en boek, en annuleer volgens de voorwaarden.
Zoeken
POST /v1/hotels/search with a destination and check-in/out dates and one to eight rooms (adults and child ages per room). The destination is a cityCode (IATA-style, e.g. "DXB" — GET /v1/content/cities lists them), a list of hotelCodes from the catalogue you store on your side (GET /v1/content/hotels per city), or a geo circle. Name matching is yours to do against your stored list; availability is always asked by code.
Met wait=true krijgt u de volledige resultatenset; met wait=false een searchId om te pollen met GET /v1/hotels/search/{searchId} — geef dezelfde data en hetzelfde aantal kamers mee, zodat tariefsleutels boekbaar blijven. Elk hotel bevat zijn content (naam, sterren, adres, geolocatie, hoofdafbeelding, voorzieningen) en het goedkoopste tarief per kamer met een ondoorzichtige rateKey, het totaal en de prijzen per nacht, verzorging, annuleerbaarheid en de annuleringstermijn.
Kamers en tarieven
GET /v1/hotels/{hotelCode}/rooms?rateKey=… toont elk kamertype en tarief van één accommodatie voor het gezochte verblijf: bedtypen, bezetting, verzorging, voorwaarden, uitgesplitste belastingen en toeslagen, en of het tarief terugbetaalbaar is.
Tariefcontrole
POST /v1/hotels/rates/{rateKey}/check bevestigt dat het tarief nog boekbaar is en geeft de definitieve prijs en voorwaarden. Doe dit vlak voor het boeken: een 409 price_changed of rate_expired hier is veel goedkoper dan een mislukte boeking.
Boeken
POST /v1/hotels/bookings met de rateKey, de hoofdboeker, gasten per kamer en een contactpersoon, plus een Idempotency-Key. De respons is de boeking met de referentie, de bevestiging van de leverancier en de vouchergegevens. GET /v1/hotels/bookings/{bookingId} geeft haar op elk moment opnieuw terug.
Annuleren
GET /v1/hotels/bookings/{bookingId}/cancellation-quote geeft de annuleringskosten volgens de voorwaarden op dit moment; POST /v1/hotels/bookings/{bookingId}/cancel (Idempotency-Key verplicht) legt de annulering vast.