Cómo buscar vuelos
El punto final de búsqueda devuelve vuelos disponibles según su ruta, fechas, número de pasajeros y clase de cabina. Admite viajes de ida y vuelta.
Punto final
POST /flights/api/v2/search
encabezados
| Encabezado | Requerido | Descripción |
|---|---|---|
x-api-key | Sí | Su clave API. |
x-correlation-id | Sí | ID de correlación capturado de los encabezados de respuesta de autocompletar. |
Cuerpo de solicitud
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
flightinfo | matriz | Sí | Conjunto de objetos de tramos de vuelo. Una entrada para viajes de ida y dos para viajes de regreso. |
flightinfo[].departuredate | cadena | Sí | Fecha de salida en formato YYYY-MM-DD. |
flightinfo[].origin | cadena | Sí | Código IATA del aeropuerto de origen (por ejemplo, SFO). |
flightinfo[].destination | cadena | Sí | Código IATA del aeropuerto de destino (por ejemplo, BLR). |
routetype | cadena | Sí | "Oneway" o "Return". |
cabin_type | cadena | Sí | "economy", "business", "premium" o "first". |
adults | entero | Sí | Número de pasajeros adultos (12+ años). |
children | entero | No | Número de niños pasajeros (2-11 años). El valor predeterminado es 0. |
infants | entero | No | Número de pasajeros infantiles (menores de 2 años). El valor predeterminado es 0. |
pagination | objeto | No | Configuración de paginación. Consulte Filtros, clasificación y paginación. |
sorting | objeto | No | Configuración de clasificación. Consulte Filtros, clasificación y paginación. |
filters | objeto | No | Criterios de filtrado. Consulte Filtros, clasificación y paginación. |
Ejemplo: búsqueda unidireccional
JSON
{
"flight_info": [
{
"departure_date": "2026-04-15",
"origin": "SFO",
"destination": "BLR"
}
],
"route_type": "Oneway",
"cabin_type": "economy",
"adults": 1,
"children": 0,
"infants": 0,
"pagination": {
"page": 1,
"limit": 10
},
"sorting": {
"sort_by": "price",
"sort_order": "asc"
}
}Ejemplo: Búsqueda de viaje de regreso
Para viajes de regreso, incluya dos entradas en flight_info: una para el tramo de ida y otra para el tramo de regreso.
JSON
{
"flight_info": [
{
"departure_date": "2026-04-15",
"origin": "SFO",
"destination": "BLR"
},
{
"departure_date": "2026-04-25",
"origin": "BLR",
"destination": "SFO"
}
],
"route_type": "Return",
"cabin_type": "business",
"adults": 2,
"children": 1,
"infants": 0
}Estructura de respuesta
La respuesta contiene una lista de vuelos, cada uno con segmentos y opciones de cabina.
JSON
{
"status": "success",
"data": {
"flights": [
{
"segments": [
{
"flight_number": "UA123",
"airline": "United Airlines",
"origin": "SFO",
"destination": "FRA",
"departure_time": "2026-04-15T10:30:00",
"arrival_time": "2026-04-16T06:45:00",
"duration": "12h 15m"
},
{
"flight_number": "LH456",
"airline": "Lufthansa",
"origin": "FRA",
"destination": "BLR",
"departure_time": "2026-04-16T09:00:00",
"arrival_time": "2026-04-16T22:30:00",
"duration": "9h 0m"
}
],
"cabins": [
{
"id": "cab_001",
"cabin": "economy",
"cabinclasstext": "Economy",
"cabinsearchsessionid": "cssabc123def456",
"base_rate": 450,
"taxandfees": 85.5,
"total_rate": 535.5,
"currency_code": "USD",
"baggage_details": {
"cabin_baggage": "1 x 7kg",
"checked_baggage": "1 x 23kg"
},
"penalties_info": {
"cancellable": true,
"exchangeable": true
}
}
]
}
],
"pagination": {
"total": 45,
"page": 1,
"limit": 10,
"total_pages": 5,
"has_next": true,
"has_prev": false
},
"available_airlines": [
"United Airlines",
"Lufthansa",
"Air India",
"Emirates"
]
},
"message": "Flights retrieved successfully"
}Campos de respuesta clave
| Campo | Descripción |
|---|---|
flights | Variedad de opciones de vuelo, cada una con segmentos y cabinas. |
flights[].segments | Tramos de vuelo individuales con aerolínea, horarios y duración. |
flights[].cabins | Opciones de cabina disponibles con precio. |
cabins[].cabinsearchsessionid | Token requerido para la verificación de disponibilidad. Guarde este valor. |
cabins[].totalrate | Precio total incluyendo impuestos y tasas. |
cabins[].baggagedetails | Franquicias de equipaje incluidas. |
cabins[].penaltiesinfo | Resumen de políticas de cancelación y cambio. |
pagination | Metadatos de paginación que incluyen resultados totales e información de la página. |
available_airlines | Lista de todas las aerolíneas en el conjunto de resultados completo. Útil para crear interfaces de usuario de filtro. |
Tipos de pasajeros
| Tipo | Rango de edad | Notas |
|---|---|---|
| Adulto | 12+ años | Se requiere al menos 1 adulto. |
| Niño | 2-11 años | Debe ir acompañado de un adulto. |
| Infantil | Menos de 2 años | Debe ir acompañado de un adulto. No puede exceder el número de adultos. |
Próximos pasos
- Cómo utilizar filtros, clasificación y paginación de búsqueda de vuelos: limita los resultados con filtros y clasificación.
- Cómo verificar la disponibilidad y los precios de los vuelos: utilice
cabinsearchsession_idpara verificar la disponibilidad.