Cómo comprobar la disponibilidad y el precio de los vuelos
Después de seleccionar un vuelo de los resultados de búsqueda, utilice el punto final de disponibilidad para recuperar información detallada del segmento, precios confirmados y un cabinavailabilitytoken necesario para las reglas de tarifas y la reserva.
Punto final
GET /flights/api/v2/availability/{cabinsearchsession_id}
encabezados
| Encabezado | Requerido | Descripción |
|---|
x-api-key | Sí | Su clave API. |
x-correlation-id | Sí | ID de correlación de la respuesta de autocompletar. |
Parámetros de ruta
| Parámetro | Tipo | Requerido | Descripción |
|---|
cabinsearchsession_id | cadena | Sí | El ID de sesión de una opción de cabina en la respuesta de búsqueda. |
Solicitud de ejemplo
GET /flights/api/v2/availability/css_abc123def456
Ejemplo de respuesta
JSON
{
"status": "success",
"data": {
"segments": [
{
"flight_number": "UA123",
"airline": "United Airlines",
"origin": "SFO",
"originairportname": "San Francisco International Airport",
"destination": "FRA",
"destinationairportname": "Frankfurt Airport",
"departure_time": "2026-04-15T10:30:00",
"arrival_time": "2026-04-16T06:45:00",
"duration": "12h 15m",
"cabin_class": "Economy",
"aircraft_type": "Boeing 787-9",
"baggage": {
"cabin_baggage": "1 x 7kg",
"checked_baggage": "1 x 23kg"
}
},
{
"flight_number": "LH456",
"airline": "Lufthansa",
"origin": "FRA",
"originairportname": "Frankfurt Airport",
"destination": "BLR",
"destinationairportname": "Kempegowda International Airport",
"departure_time": "2026-04-16T09:00:00",
"arrival_time": "2026-04-16T22:30:00",
"duration": "9h 0m",
"cabin_class": "Economy",
"aircraft_type": "Airbus A350-900",
"layover": {
"airport": "FRA",
"duration": "2h 15m"
},
"baggage": {
"cabin_baggage": "1 x 7kg",
"checked_baggage": "1 x 23kg"
}
}
],
"pricing": {
"base_price": 450,
"taxandfees": 85.5,
"total_price": 535.5,
"currency_code": "USD"
},
"ispassportrequired": true,
"hold_allowed": true,
"cabinavailabilitytoken": "cat_xyz789abc123"
},
"message": "Availability retrieved successfully"
}
Campos de respuesta
Segmentos
| Campo | Descripción |
|---|
flightnumber | Número de vuelo de la aerolínea. |
airline | Nombre de la aerolínea operativa. |
origin / destination | Códigos de aeropuerto IATA. |
originairportname / destinationairportname | Nombres completos de los aeropuertos. |
departuretime / arrivaltime | Marcas de tiempo ISO 8601. |
duration | Duración del vuelo para este segmento. |
cabinclass | Clase de cabina para este segmento. |
aircraft_type | Modelo de avión. |
layover | Detalles de escala (presentes en los segmentos de conexión). Incluye código de aeropuerto y duración. |
baggage | Incluye franquicias de equipaje de cabina y facturado. |
Precios
| Campo | Descripción |
|---|
baseprice | Tarifa base antes de impuestos. |
taxandfees | Impuestos y tasas totales. |
totalprice | Precio final incluyendo todos los impuestos y tasas. |
currency_code | Moneda del precio cotizado (por ejemplo, USD). |
Marcas de reserva
| Campo | Tipo | Descripción |
|---|
ispassportrequired | booleano | Si se requieren los datos del pasaporte durante la reserva. Si true, deberá incluir información del pasaporte en los datos del viajero. |
holdallowed | booleano | Si la reserva se puede realizar sin pago inmediato. |
cabinavailability_token | cadena | Token requerido para la búsqueda de reglas de tarifas y la creación de reservas. Guarde este valor. |
Encadenamiento de tokens
El cabinavailabilitytoken devuelto por este punto final se utiliza en dos llamadas posteriores:
- Reglas de tarifas —
GET /flights/api/v2/farerules/{cabinavailabilitytoken} - Crear reserva —
POST /flights/api/v2/bookings (aprobado en el cuerpo de la solicitud)
Asegúrese de almacenar este token después de una verificación de disponibilidad exitosa.
Consejos
- Consulta siempre disponibilidad antes de reservar. Los resultados de la búsqueda muestran precios estimados; el punto final de disponibilidad proporciona precios confirmados en tiempo real.
- Si
ispassportrequired es true, asegúrese de recopilar los datos del pasaporte de todos los viajeros antes de llamar al punto final de reserva. - Si
hold_allowed es true, podrás crear la reserva y confirmarla más tarde dentro del tiempo límite del ticket.
Artículos relacionados
