Primeros pasos con la API de actividades de Xeni Cómo reservar una actividad Cómo buscar etiquetas y categorías de actividades Cómo cancelar una reserva de actividad Cómo comprobar la disponibilidad de la actividad Cómo obtener detalles de la actividad Cómo recuperar los detalles de la reserva de actividades Cómo buscar actividades con filtros Cómo buscar destinos de actividades API de alquiler de coches: introducción API de alquiler de coches: comprensión de los campos de respuesta Cómo reservar un alquiler de coches Cómo obtener detalles del vehículo de alquiler y complementos de equipo Cómo recuperar o cancelar una reserva de alquiler de coches Cómo buscar autos de alquiler disponibles Cómo buscar ubicaciones de recogida Cómo utilizar los filtros de búsqueda de alquiler de coches Mejores prácticas de integración de API de ofertas Preguntas frecuentes sobre la API de ofertas Primeros pasos con la API de ofertas de Xeni Referencia de encabezados y parámetros de solicitud de API de ofertas Ofertas API Monedas admitidas y localización Cómo mostrar ofertas en su aplicación Cómo buscar ofertas de hoteles por ubicación Códigos de error de la API de vuelos y solución de problemas Primeros pasos con la API de vuelos de Xeni Cómo reservar un vuelo Cómo comprobar la disponibilidad y el precio de los vuelos Cómo confirmar o cancelar una reserva de vuelo Cómo recuperar las reglas de tarifas de un vuelo Cómo recuperar los detalles de la reserva de un vuelo Cómo buscar aeropuertos usando Autocompletar Cómo buscar vuelos Cómo utilizar filtros, clasificación y paginación de búsqueda de vuelos Cómo comprobar la disponibilidad y el precio de las habitaciones Cómo filtrar los resultados de los alquileres vacacionales Cómo obtener detalles, comodidades y accesibilidad de la propiedad del resort Cómo mantener y confirmar una reserva de resort Cómo liberar una retención de resort Cómo recuperar los detalles de la reserva del resort Cómo buscar complejos turísticos disponibles Cómo buscar destinos turísticos Cómo buscar ubicaciones de alquiler vacacional Cómo buscar alquileres vacacionales Cómo utilizar filtros de búsqueda y clasificación de complejos turísticos Comenzando con la API de Xeni Resorts API de Resorts: comprensión de los estados y políticas de las reservas Primeros pasos con la API de alquileres vacacionales Preguntas frecuentes sobre alquileres vacacionales Tipos de propiedades admitidas para alquileres vacacionales Comprensión de la búsqueda asincrónica para alquileres vacacionales Autenticación y firmas API Reserva de hoteles: API directa y pago SSO Manejo de errores, límites de tasas y mejores prácticas Primeros pasos con la API de Xeni Hoteles Gestión de reservas: estado, recuperación y cancelación Confirmación de precios y ciclo de vida del token Recuperar detalles del hotel y disponibilidad de habitaciones Búsqueda de hoteles: ubicaciones, filtros y paginación Buscando Hoteles Gestión de sesiones e ID de correlación Autenticación API y obtención de claves API

Cómo recuperar los detalles de la reserva de un vuelo

Última actualización: 2026-03-03

Cómo recuperar los detalles de la reserva de vuelos

Utilice el punto final de obtención de reservas para recuperar los detalles completos de una reserva existente, incluidos segmentos de vuelo, información del viajero, precios y estado actual.

Punto final

GET /flights/api/v2/bookings?bookingid={bookingid}

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 consulta

Parámetro	Tipo	Requerido	Descripción
`booking_id`	cadena	Sí	El ID de reserva devuelto cuando se creó la reserva.

Solicitud de ejemplo

GET /flights/api/v2/bookings?booking_id=XNFiEtVA3LL

Ejemplo de respuesta

JSON

{
  "status": "success",
  "data": {
    "travel_date": "2026-04-15",
    "booking_id": "XNFiEtVA3LL",
    "airline_pnr": "ABC123",
    "booking_status": "TICKETED",
    "trip_type": "Oneway",
    "flight_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",
        "status": "CONFIRMED"
      },
      {
        "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",
        "status": "CONFIRMED"
      }
    ],
    "traveller_details": [
      {
        "type": "ADULT",
        "title": "Mr",
        "first_name": "John",
        "last_name": "Smith",
        "dateofbirth": "1985-06-15",
        "ticket_number": "0161234567890"
      },
      {
        "type": "CHILD",
        "title": "Miss",
        "first_name": "Emma",
        "last_name": "Smith",
        "dateofbirth": "2018-03-22",
        "ticket_number": "0169876543210"
      }
    ],
    "pricing": {
      "base_price": 900,
      "taxandfees": 171,
      "total_price": 1071,
      "currency_code": "USD"
    },
    "tickettimelimit": "2026-04-14T23:59:00Z"
  },
  "message": "Booking details retrieved successfully"
}

Campos de respuesta

Información de reserva

Campo	Tipo	Descripción
`traveldate`	cadena	Fecha de viaje principal (`YYYY-MM-DD`).
`bookingid`	cadena	Identificador de reserva de Xeni.
`airlinepnr`	cadena	PNR (registro de nombres de pasajeros) de aerolínea / código de confirmación. Comparta esto con los viajeros para el check-in de la aerolínea.
`bookingstatus`	cadena	Estado actual de la reserva. Consulte la referencia de estado a continuación.
`triptype`	cadena	`"Oneway"` o `"Return"`.
`tickettime_limit`	cadena	Fecha límite para confirmar la reserva (ISO 8601). Solo es relevante para el estado `BOOKED`.

Segmentos de vuelo

Campo	Tipo	Descripción
`flightnumber`	cadena	Número de vuelo de la aerolínea.
`airline`	cadena	Línea aérea operativa.
`origin` / `destination`	cadena	Códigos de aeropuerto IATA.
`originairportname` / `destination``airportname`	cadena	Nombres completos de los aeropuertos.
`departuretime` / `arrivaltime`	cadena	Marcas de tiempo ISO 8601.
`duration`	cadena	Duración del vuelo del segmento.
`cabinclass`	cadena	Clase de cabina para este segmento.
`status`	cadena	Estado del segmento (por ejemplo, `CONFIRMED`, `CANCELLED`).

Detalles del viajero

Campo	Tipo	Descripción
`type`	cadena	Tipo de pasajero (`ADULT`, `CHILD`, `INFANT`).
`title`	cadena	Título (`Mr`, `Mrs`, `Ms`, `Miss`).
`firstname` / `last``name`	cadena	Nombre del viajero.
`dateofbirth`	cadena	Fecha de nacimiento (`YYYY-MM-DD`).
`ticket_number`	cadena	Número de ticket emitido (presente cuando el estado es `TICKETED`).

Precios

Campo	Tipo	Descripción
`baseprice`	número	Tarifa base antes de impuestos (total para todos los pasajeros).
`taxandfees`	número	Impuestos y tasas totales.
`totalprice`	número	Precio total final.
`currency_code`	cadena	Moneda del precio.

Referencia del estado de la reserva

Estado	Descripción
`BOOKED`	Se mantiene la reserva. Confirme antes del límite de tiempo del boleto.
`TICKETED`	Se han emitido billetes.
`TICKETINPROCESS`	Se está procesando la emisión de boletos.
`CANCELLED`	La reserva ha sido cancelada.

Casos de uso

Mostrar confirmación de reserva: muestra a los viajeros su itinerario, PNR y números de boleto después de la reserva.
Verificar el estado de emisión de boletos: sondee este punto final después de la confirmación para verificar que se haya completado la emisión de boletos (si la respuesta de confirmación arrojó TICKETINPROCESS).
Revisión previa a la cancelación: recupere los detalles de la reserva para mostrar el itinerario y los precios antes de que el usuario confirme la cancelación.