Vlucht-API

Tariefkalender

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 geeft het goedkoopste gecachete tarief per dag voor de route, in uw valuta, met hoe actueel de cache is. Voeg returnFrom / returnTo toe voor retourtotalen per datumpaar, en cabin om de klasse te beperken. Het wordt geserveerd vanuit onze prijscache — direct, en het telt nooit als leverancierszoekopdracht — dus gebruik het om een kalender of een strook met “goedkoopste dagen” te tekenen vóór de echte zoekopdracht.

Zoeken

POST /v1/flights/search met één traject voor enkele reis, twee voor een retour, tot zes voor multi-city; aantallen passagiers per type; optioneel een cabine en een maximaal aantal overstappen (maxStops). Met wait=true bevat de respons elke offer zodra alle leveranciers hebben geantwoord; met wait=false krijgt u een searchId en pollt u GET /v1/flights/search/{searchId} met een cursor tot complete true is.

Elke offer bevat een ondoorzichtige offerId, het totaal in uw valuta met de uitsplitsing per passagier, trajecten → segmenten (maatschappij, vluchtnummer, tijden, toestel, cabine, bagage), een samenvatting van de tariefvoorwaarden en een vervaltijd. Offers zijn geldig zolang de zoeksessie duurt (ongeveer 20 minuten).

Prijzen en regels

POST /v1/flights/offers/{offerId}/price valideert het tarief vlak voordat u vastlegt opnieuw bij de leverancier en geeft de bevestigde prijs, belastingen en de passagiersvelden die de luchtvaartmaatschappij vereist (documenten, geboortedata, frequent flyer). GET .../fare-rules geeft de tekst van de boeteregels; GET .../ancillaries toont betaalde bagage en opties die u aan de order kunt toevoegen.

Extra's (extra bagage)

GET /v1/flights/offers/{offerId}/ancillaries toont de betaalde extra's die de luchtvaartmaatschappij op dat tarief aanbiedt — momenteel extra ruimbagage, elk met een key, stuks / gewicht en een prijs per passagier. Betaald betekent dat ze bovenop het tarief worden geprijsd en met de order worden gefactureerd, anders dan de inbegrepen bagage die bij de offer zelf wordt getoond.

Om ze te kopen, voegt u ancillaries[] toe aan POST /v1/flights/orders: één item per extra met de key en de passengerIndex (0-gebaseerd in passengers). Ze worden samen met de order geprijsd, geboekt en geticket en verschijnen in de tickettotalen van de order. Extra's kunnen niet worden toegevoegd aan een order die al is geticket; stoelkeuze volgt hetzelfde patroon.

{
  "offerId": "fo_7Gk2Qp9LcKM5aGqrMQOIzJko",
  "passengers": [{ "type": "ADT", "gender": "M", "firstName": "SAM", "lastName": "TRAVELLER", "dateOfBirth": "1990-05-04" }],
  "contact": { "email": "[email protected]", "phone": "+971501234567" },
  "ancillaries": [{ "key": "BAG20-1", "passengerIndex": 0 }]
}

De order aanmaken

POST /v1/flights/orders met de offerId, passagiers (namen zoals in het paspoort, type, geboortedatum, reisdocument voor internationale reisroutes), een contactpersoon en optioneel ancillaries[] (zie hierboven); voeg een Idempotency-Key toe. U ontvangt een orderId, de PNR van de luchtvaartmaatschappij, de ticketingtermijn en de status held. In de sandbox komt de order in het testsysteem van de leverancier terecht en wordt er niets in rekening gebracht; in productie wordt het deposito gereserveerd.

Tickets uitgeven

POST /v1/flights/orders/{orderId}/issue (Idempotency-Key verplicht) geeft e-tickets uit en retourneert de ticketnummers per passagier. Lees de order op elk moment met GET /v1/flights/orders/{orderId}; de status loopt van held → issued → cancelled/refunded.

Voiden, annuleren en terugbetalen

GET /v1/flights/orders/{orderId}/refund-quote vertelt u wat een annulering volgens de tariefregels oplevert (een void op dezelfde dag is meestal gratis). POST /v1/flights/orders/{orderId}/cancel legt het vast; de terugbetaling komt op uw depositogrootboek, zichtbaar in het ontwikkelaarsportaal.