Flyg-API

Priskalender

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 returnerar det billigaste cachade priset per dag för sträckan, i din valuta, tillsammans med hur färsk cachen är. Lägg till returnFrom / returnTo för tur och retur-summor per datumpar och cabin för att begränsa klassen. Den hämtas från vår priscache – omedelbart, och räknas aldrig som en leverantörssökning – så använd den för att rita en kalender eller en remsa med ”billigaste dagarna” före den riktiga sökningen.

Sökning

POST /v1/flights/search med en delsträcka för enkelresa, två för tur och retur och upp till sex för flerstadsresor; antal passagerare per typ; valfri kabinklass och ett maximalt antal mellanlandningar (maxStops). Med wait=true innehåller svaret alla erbjudanden när alla leverantörer har svarat; med wait=false får du ett searchId och pollar GET /v1/flights/search/{searchId} med en markör tills complete är true.

Varje erbjudande har ett ogenomskinligt offerId, totalbeloppet i din valuta med uppdelning per passagerare, delsträckor → segment (flygbolag, flightnummer, tider, flygplan, kabin, bagage), en sammanfattning av biljettvillkoren och en giltighetstid. Erbjudanden gäller under söksessionens livstid (cirka 20 minuter).

Pris och regler

POST /v1/flights/offers/{offerId}/price revaliderar priset hos leverantören precis innan du binder dig och returnerar det bekräftade priset, skatterna och de passagerarfält som flygbolaget kräver (dokument, födelsedatum, bonusprogram). GET .../fare-rules returnerar texten om avgifter; GET .../ancillaries listar betalt bagage och tillval som du kan lägga till i ordern.

Tilläggstjänster (extra bagage)

GET /v1/flights/offers/{offerId}/ancillaries listar de avgiftsbelagda extratjänster som flygbolaget erbjuder på det priset – i dag extra incheckat bagage, var och en med en key, antal kollin / vikt och ett pris per passagerare. Avgiftsbelagd betyder att de prissätts utöver biljettpriset och debiteras med ordern, till skillnad från det inkluderade bagaget som visas i själva erbjudandet.

För att köpa dem lägger du till ancillaries[] i POST /v1/flights/orders: en post per extratjänst med key och passengerIndex (0-baserat index i passengers). De prissätts, bokas och biljetteras tillsammans med ordern och syns i orderns biljettsummor. Extratjänster kan inte läggas till i en order som redan är biljetterad; platsval kommer att följa samma mönster.

{
  "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 }]
}

Skapa ordern

POST /v1/flights/orders med offerId, passagerare (namn som i passet, typ, födelsedatum, dokument för internationella resvägar), en kontakt och valfritt ancillaries[] (se ovan); lägg till en Idempotency-Key. Du får ett orderId, flygbolagets PNR, sista tid för biljettutfärdande och statusen held. I sandboxen hamnar ordern i leverantörens testsystem och inget debiteras; i produktion reserveras beloppet på depositionen.

Utfärda biljetter

POST /v1/flights/orders/{orderId}/issue (Idempotency-Key krävs) utfärdar e-biljetter och returnerar biljettnummer per passagerare. Läs ordern när som helst med GET /v1/flights/orders/{orderId}; statusen går från held → issued → cancelled/refunded.

Makulering, avbokning och återbetalning

GET /v1/flights/orders/{orderId}/refund-quote visar vad en avbokning ger tillbaka enligt biljettvillkoren (makulering samma dag är oftast kostnadsfri). POST /v1/flights/orders/{orderId}/cancel genomför den; återbetalningen hamnar i depositionens kontoutdrag och syns i utvecklarportalen.