API voli

Ricerca e prenotazione voli, dall'inizio alla fine

Cerca tariffe in tempo reale su più fonti, rivalida il prezzo, prenota ed emetti i biglietti. Un set di endpoint REST, prezzi in USD.

POST /Air/AirLowFareSearch
{
  "AdultCount": 1,
  "TravelPreference": { "CabinType": 3 },
  "OriginDestinationInformations": [
    { "OriginLocationCode": "TBS",
      "DestinationLocationCode": "DXB",
      "DepartureDateTime": "2026-11-14T00:00:00" }
  ]
}
Panoramica

Il contenuto delle compagnie è frammentato e ogni fonte parla il proprio dialetto. Questa API di prenotazione voli unifica ricerca, regole tariffarie, bagagli, prenotazione, emissione e rimborsi dietro un contratto JSON coerente.

Dietro gli endpoint c'è un motore tariffario normalizzato che dialoga con i sistemi globali di distribuzione e i vettori low-cost tramite un unico contratto JSON. Ottieni itinerari, regole tariffarie, bagagli e dati sui posti coerenti, che il contenuto arrivi da un GDS o da un collegamento diretto con la compagnia, così la tua app di prenotazione voli o OTA si integra una volta e scala ovunque.

Cosa ottieni

1

Cerca l'itinerario più economico per gruppo di volo, oppure ricevi i risultati via server-sent events per un primo rendering rapido.

2

Rivalida la tariffa subito prima di prenotare, così il prezzo che addebiti è quello che ottieni.

3

Gestisci l'intero ciclo: blocca un posto, emetti il biglietto, poi monitora, annulla o rimborsa.

4

Trasmetti gli itinerari via server-sent events per un primo rendering rapido sulle tratte lente.

5

Post-emissione completa: recupera i documenti, annulla entro la finestra, cancella e rimborsa.

Come funziona il flusso

01

Search

Post routes and dates, get priced itineraries back, or stream them over server-sent events.

02

Revalidate

Re-price the chosen itinerary right before booking so the fare you charge is the fare you get.

03

Book

Create the booking, hold the seats, and receive a booking reference.

04

Issue

Issue the ticket against your balance, then track, void, cancel, or refund.

Endpoint principali

POST/Air/AirLowFareSearchSearch the cheapest itinerary per flight group.
POST/Air/AirLowFareSearchStreamStream itineraries over server-sent events.
POST/Air/AirRevalidateRe-price and validate an itinerary before booking.
POST/Air/AirBookCreate the booking and hold seats.
POST/Air/AirTicketIssue the ticket for a booking.
GET/Air/AirBookingDetailsRetrieve a booking, its status, and documents.

Richiesta e risposta

Request · POST /Air/AirLowFareSearch
{
  "AdultCount": 1,
  "TravelPreference": { "CabinType": 3 },
  "OriginDestinationInformations": [
    { "OriginLocationCode": "TBS",
      "DestinationLocationCode": "DXB",
      "DepartureDateTime": "2026-11-14T00:00:00" }
  ]
}
Response · 200 OK
{
  "itineraries": [
    {
      "fareCode": "TBSDXB-Y-412",
      "total": { "amount": 412.00, "currency": "USD" },
      "seatsRemaining": 5,
      "segments": [
        { "from": "TBS", "to": "DXB",
          "depart": "2026-11-14T09:40",
          "carrier": "EK", "flight": "2201" }
      ]
    }
  ]
}

Cosa include la risposta

fareCode
Opaque identifier you pass to revalidate and book.
total
Final price with currency, already normalized to USD.
seatsRemaining
Bookable seats left at this fare.
segments
Each flight leg with carrier, flight number, times, and airports.
baggage
Included allowance and paid options per segment.
1.000+

Compagnie aeree

Domande frequenti

Cosa restituisce la ricerca voli?

Itinerari con prezzo, ciascuno con codice tariffa, segmenti di volo, totale in USD e posti rimanenti.

Posso ricevere risultati in streaming?

Sì. L'endpoint di ricerca incrementale invia gli itinerari via server-sent events man mano che arrivano.

Come faccio a testare in sicurezza?

Punta il client al sandbox. La ricerca è reale; la chiamata di emissione è simulata su un saldo separato.

Supportate solo andata, andata e ritorno e multi-city?

Sì. Invia una o più coppie origine-destinazione nello stesso corpo di ricerca; solo andata, andata e ritorno e multi-city usano la stessa forma.

Come vengono gestiti i rimborsi?

Annulla entro la finestra del vettore oppure richiedi un rimborso dopo l'emissione. L'API restituisce l'importo rimborsabile e lo stato risultante.

Costruisci il tuo prodotto di viaggio su un'unica API.

Integrazione gratuita. 1% per biglietto emesso, con tetto di 10 $. Copertura dal vivo di voli, hotel e attività.