Fly-API

Priskalender

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 returnerer den billigste cachede pris pr. dag for ruten i din valuta og angiver, hvor frisk cachen er. Tilføj returnFrom / returnTo for returtotaler pr. datopar og cabin for at begrænse klassen. Den leveres fra vores priscache — øjeblikkeligt, og den tæller aldrig som en leverandørsøgning — så brug den til at tegne en kalender eller en stribe med “billigste dage” før den egentlige søgning.

Søgning

POST /v1/flights/search med ét rejseafsnit for enkeltrejse, to for returrejse og op til seks for flere destinationer; antal passagerer pr. type; en valgfri kabine og et maksimalt antal mellemlandinger (maxStops). Med wait=true indeholder svaret alle tilbud, når alle leverandører har svaret; med wait=false får du et searchId og poller GET /v1/flights/search/{searchId} med en cursor, indtil complete er true.

Hvert tilbud har et uigennemsigtigt offerId, totalen i din valuta med opdeling pr. passager, rejseafsnit → segmenter (flyselskab, flynummer, tider, flytype, kabine, bagage), et resumé af prisbetingelserne og et udløbstidspunkt. Tilbud er gyldige i søgesessionens levetid (cirka 20 minutter).

Pris og regler

POST /v1/flights/offers/{offerId}/price genvaliderer prisen hos leverandøren lige før du forpligter dig og returnerer den bekræftede pris, skatter og de passagerfelter, flyselskabet kræver (dokumenter, fødselsdatoer, bonusprogram). GET .../fare-rules returnerer teksten om gebyrer; GET .../ancillaries viser betalte bagage- og tilvalgsmuligheder, du kan føje til ordren.

Tillægsydelser (ekstra bagage)

GET /v1/flights/offers/{offerId}/ancillaries viser de betalte ekstraydelser, som flyselskabet tilbyder på den pris — i dag ekstra indskrevet bagage, hver med en key, antal kolli / vægt og en pris pr. passager. Betalt betyder, at de prissættes oven i billetprisen og faktureres med ordren, i modsætning til den inkluderede bagage, der vises på selve tilbuddet.

For at købe dem skal du tilføje ancillaries[] til POST /v1/flights/orders: én post pr. ekstraydelse med key og passengerIndex (0-baseret indeks i passengers). De prissættes, bookes og udstedes sammen med ordren og vises i ordrens billettotaler. Ekstraydelser kan ikke føjes til en ordre, der allerede er udstedt; sædevalg vil følge samme 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 }]
}

Opret ordren

POST /v1/flights/orders med offerId, passagerer (navne som i passet, type, fødselsdato, dokument ved internationale rejseruter), kontaktoplysninger og valgfrit ancillaries[] (se ovenfor); tilføj en Idempotency-Key. Du modtager et orderId, flyselskabets PNR, fristen for billetudstedelse og status held. I testmiljøet lander ordren i leverandørens testsystem, og intet opkræves; i produktion reserveres beløbet i depositummet.

Udsted billetter

POST /v1/flights/orders/{orderId}/issue (Idempotency-Key påkrævet) udsteder e-billetter og returnerer billetnumre pr. passager. Læs ordren når som helst med GET /v1/flights/orders/{orderId}; status går gennem held → issued → cancelled/refunded.

Void, annullering og refusion

GET /v1/flights/orders/{orderId}/refund-quote fortæller, hvad en annullering giver tilbage efter prisreglerne (en void samme dag er normalt gratis). POST /v1/flights/orders/{orderId}/cancel gennemfører den; refusionen lander i hovedbogen for dit depositum og kan ses i udviklerportalen.