Fly-API

Priskalender

GET /v1/flights/price-calendar?origin=DXB&destination=LHR&departureFrom=2026-11-01&departureTo=2026-11-30 returnerer den billigste bufrede prisen per dag for ruten, i din valuta, med hvor fersk bufferen er. Legg til returnFrom / returnTo for tur-retur-totaler per datopar, og cabin for å begrense klassen. Den leveres fra prisbufferen vår – umiddelbart, og teller aldri som et leverandørsøk – så bruk den til å tegne en kalender eller en «billigste dager»-stripe før det egentlige søket.

Søk

POST /v1/flights/search med én strekning for enveis, to for tur-retur og opptil seks for flere byer; antall passasjerer per type; en valgfri kabin og et maksimalt antall mellomlandinger (maxStops). Med wait=true inneholder svaret alle tilbud når alle leverandører har svart; med wait=false får du en searchId og poller GET /v1/flights/search/{searchId} med en markør til complete er true.

Hvert tilbud har en ugjennomsiktig offerId, totalbeløpet i din valuta med fordeling per passasjer, strekninger → segmenter (flyselskap, flightnummer, tider, flytype, kabin, bagasje), et sammendrag av billettvilkårene og et utløpstidspunkt. Tilbudene er gyldige så lenge søkeøkten varer (omtrent 20 minutter).

Pris og regler

POST /v1/flights/offers/{offerId}/price revaliderer billettprisen hos leverandøren rett før du forplikter deg, og returnerer bekreftet pris, avgifter og passasjerfeltene flyselskapet krever (dokumenter, fødselsdatoer, bonusprogram). GET .../fare-rules returnerer teksten om gebyrer; GET .../ancillaries lister betalte bagasjealternativer og valg du kan legge til i ordren.

Tilleggstjenester (ekstra bagasje)

GET /v1/flights/offers/{offerId}/ancillaries lister de betalte tilleggene flyselskapet tilbyr på den billettprisen – i dag ekstra innsjekket bagasje, hver med en key, antall kolli / vekt og en pris per passasjer. Betalt betyr at de prises i tillegg til billettprisen og faktureres med ordren, i motsetning til den inkluderte bagasjen som vises på selve tilbudet.

For å kjøpe dem legger du til ancillaries[] i POST /v1/flights/orders: én oppføring per tillegg med key og passengerIndex (0-basert indeks i passengers). De prises, bestilles og billetteres sammen med ordren og vises i ordrens billettotaler. Tillegg kan ikke legges til en ordre som allerede er billettert; setevalg 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 }]
}

Opprett ordren

POST /v1/flights/orders med offerId, passasjerer (navn som i passet, type, fødselsdato, dokument for internasjonale reiseruter), en kontaktperson og valgfrie ancillaries[] (se over); legg til en Idempotency-Key. Du får en orderId, flyselskapets PNR, tidsfristen for billettutstedelse og statusen held. I sandkassen havner ordren i leverandørens testsystem og ingenting belastes; i produksjon reserveres beløpet på depositumet.

Utsted billetter

POST /v1/flights/orders/{orderId}/issue (Idempotency-Key påkrevd) utsteder e-billetter og returnerer billettnumre per passasjer. Les ordren når som helst med GET /v1/flights/orders/{orderId}; statusen går gjennom held → issued → cancelled/refunded.

Annuller, kanseller og refunder

GET /v1/flights/orders/{orderId}/refund-quote forteller hva en kansellering gir tilbake etter billettreglene (annullering samme dag er vanligvis gratis). POST /v1/flights/orders/{orderId}/cancel gjennomfører den; refusjonen føres i depositumsreskontroen din, synlig i utviklerportalen.