GET/v1/flights/offers/:gdsprovider/:offerId

Obtener detalle de oferta de vuelo

Recupera el detalle actualizado de una oferta de vuelo antes de reservar, incluyendo precio, condiciones, segmentos y requisitos de pasajeros cuando estén disponibles.

Endpoint

Método	Ruta	Auth
`GET`	`/v1/flights/offers/:gdsprovider/:offerId`	API key requerida

Headers obligatorios:

Header	Descripción
`Authorization`	`Bearer <secret_key>`. The secret is shown only once when the credential is created.
`X-Travelandz-Id`	`<public_key>:<profile_code>`. The `profile_code` is the `dp_`-prefixed Developer Profile code shown in your dashboard. This binds the request to a profile and credential.
`Content-Type`	Use `application/json` for requests with a body.

Esquema de parámetros de la petición

Propiedad	Tipo	Detalles	Requerido	Notas
`gdsprovider`	`number`		Sí	-
`offerId`	`string`		Sí	-

Respuesta exitosa

Devuelve offerData with the selected offer, passenger ids, document requirements, hold options and flight segments when supported.

Esquema del cuerpo de la respuesta

Propiedad	Tipo	Detalles	Requerido	Notas
`offerData`	`object`		Sí	-
`offerDataofferId`	`string`		Sí	-
`offerDataofferLink`	`string`		Nulable	-
`offerDatagdsprovider`	`number`		Sí	-
`offerDataexpiresAt`	`string`	`Format: ISO 8601`	Sí	-
`offerDatatotalAmount`	`number`		Sí	-
`offerDataoriginalTotalAmount`	`number`		Sí	-
`offerDataholdOptions`	`object`		Sí	-
`offerDataholdOptionsavailable`	`boolean`		Sí	-
`offerDataholdOptionspaymentRequiredBy`	`string`	`Format: ISO 8601`	Nulable	-
`offerDataholdOptionspriceGuarantedUntil`	`string`	`Format: ISO 8601`	Nulable	-
`offerDatasupportedPassengerIdDocuments`	`array`		Sí	-
`offerDatasupportedPassengerIdDocuments[]`	`enum[]`		Sí	-

`offerDatapassengerIdentityDocumentsRequired`	`boolean`		Sí	-
`offerDatasupportedLoyaltyPrograms`	`array`		Sí	-
`offerDatasupportedLoyaltyPrograms[]`	`string[]`		Sí	-

`offerDataairline`	`object`		Sí	-
`offerDataairlinename`	`string`		Sí	-
`offerDataairlineiataCode`	`string`		Sí	-
`offerDataairlinelogoURL`	`string`		Nulable	-
`offerDataairlineconditionsOfCarriage`	`string`		No	-
`offerDatapassengers`	`array`		Sí	-
`offerDatapassengers[]id`	`string`		Sí	-
`offerDatapassengers[]type`	`enum`	`adultchildinfant_without_seat`	Sí	-

`offerDataconditions`	`object`		Sí	-
`offerDataconditionsrefundBeforeDeparture`	`object`		Sí	-
`offerDataconditionsrefundBeforeDeparturecurrency`	`string`		Sí	-
`offerDataconditionsrefundBeforeDeparturepenaltyAmount`	`string`		Sí	-
`offerDataconditionsrefundBeforeDepartureallowed`	`boolean`		Sí	-
`offerDataconditionschangeBeforeDeparture`	`object`		Sí	-
`offerDataconditionschangeBeforeDeparturecurrency`	`string`		Sí	-
`offerDataconditionschangeBeforeDeparturepenaltyAmount`	`string`		Sí	-
`offerDataconditionschangeBeforeDepartureallowed`	`boolean`		Sí	-
`offerDataslices`	`array`		Sí	-
`offerDataslices[]fareName`	`string`		Sí	-
`offerDataslices[]departure`	`object`		Sí	-
`offerDataslices[]departureiataCode`	`string`		Sí	-
`offerDataslices[]departurecityName`	`string`		Sí	-
`offerDataslices[]departureairportName`	`string`		No	-
`offerDataslices[]departuredepartingAt`	`string`	`Format: ISO 8601`	Sí	-
`offerDataslices[]departuretimeZone`	`string`		No	-
`offerDataslices[]arrival`	`object`		Sí	-
`offerDataslices[]arrivaliataCode`	`string`		Sí	-
`offerDataslices[]arrivalcityName`	`string`		Sí	-
`offerDataslices[]arrivalairportName`	`string`		No	-
`offerDataslices[]arrivalarrivingAt`	`string`	`Format: ISO 8601`	Sí	-
`offerDataslices[]arrivaltimeZone`	`string`		No	-
`offerDataslices[]durationMinutes`	`number`		Sí	-
`offerDataslices[]conditions`	`object`		Sí	-
`offerDataslices[]conditionspriorityCheckIn`	`boolean`		Sí	-
`offerDataslices[]conditionspriorityBoarding`	`boolean`		Sí	-
`offerDataslices[]conditionsadvanceSeatSelection`	`boolean`		Sí	-
`offerDataslices[]segments`	`array`		Sí	-
`offerDataslices[]segments[]fareName`	`string`		Sí	-
`offerDataslices[]segments[]departure`	`object`		Sí	-
`offerDataslices[]segments[]departureiataCode`	`string`		Sí	-
`offerDataslices[]segments[]departurecityName`	`string`		Sí	-
`offerDataslices[]segments[]departureairportName`	`string`		No	-
`offerDataslices[]segments[]departuredepartingAt`	`string`	`Format: ISO 8601`	Sí	-
`offerDataslices[]segments[]departuretimeZone`	`string`		No	-
`offerDataslices[]segments[]departureterminal`	`string`		No	-
`offerDataslices[]segments[]arrival`	`object`		Sí	-
`offerDataslices[]segments[]arrivaliataCode`	`string`		Sí	-
`offerDataslices[]segments[]arrivalcityName`	`string`		Sí	-
`offerDataslices[]segments[]arrivalairportName`	`string`		No	-
`offerDataslices[]segments[]arrivalarrivingAt`	`string`	`Format: ISO 8601`	Sí	-
`offerDataslices[]segments[]arrivaltimeZone`	`string`		No	-
`offerDataslices[]segments[]arrivalterminal`	`string`		No	-
`offerDataslices[]segments[]airline`	`object`		Sí	-
`offerDataslices[]segments[]airlineoperatingCarrier`	`object`		Sí	-
`offerDataslices[]segments[]airlineoperatingCarriername`	`string`		Sí	-
`offerDataslices[]segments[]airlineoperatingCarrieriataCode`	`string`		Sí	-
`offerDataslices[]segments[]airlineoperatingCarrierlogoURL`	`string`		Nulable	-
`offerDataslices[]segments[]airlineoperatingCarrierconditionsOfCarriage`	`string`		No	-
`offerDataslices[]segments[]airlinemarketingCarrier`	`object`		Sí	-
`offerDataslices[]segments[]airlinemarketingCarriername`	`string`		Sí	-
`offerDataslices[]segments[]airlinemarketingCarrieriataCode`	`string`		Sí	-
`offerDataslices[]segments[]airlinemarketingCarrierlogoURL`	`string`		Nulable	-
`offerDataslices[]segments[]airlinemarketingCarrierconditionsOfCarriage`	`string`		No	-
`offerDataslices[]segments[]flightNumber`	`string`		Sí	-
`offerDataslices[]segments[]durationMinutes`	`number`		Sí	-
`offerDataslices[]segments[]passengers`	`array`		Sí	-
`offerDataslices[]segments[]passengers[]amenities`	`object`		Sí	-
`offerDataslices[]segments[]passengers[]amenitieswifi`	`object`		Sí	-
`offerDataslices[]segments[]passengers[]amenitieswificost`	`enum`	`freefree or paidpaid`	Nulable	-
`offerDataslices[]segments[]passengers[]amenitieswifiavailable`	`boolean`		Sí	-
`offerDataslices[]segments[]passengers[]amenitiesseat`	`object`		Sí	-
`offerDataslices[]segments[]passengers[]amenitiesseatpitch`	`enum`	`"number"n/a`	Sí	-
`offerDataslices[]segments[]passengers[]amenitiesseatlegroom`	`enum`	`lessmorestandardn/a`	Sí	-
`offerDataslices[]segments[]passengers[]amenitiesseattype`	`enum`	`standardskycouchreclinerangle_flatfull_flatfull_flat_podprivate_suite`	Nulable	-
`offerDataslices[]segments[]passengers[]amenitiespower`	`boolean`		Sí	-
`offerDataslices[]segments[]passengers[]baggages`	`array`		Sí	-
`offerDataslices[]segments[]passengers[]baggages[]type`	`enum`	`checkedcarry_on`	Sí	-
`offerDataslices[]segments[]passengers[]baggages[]quantity`	`number`		Sí	-
`offerDataslices[]segments[]passengers[]baggages[]maxKg`	`string`		No	-

`offerDataCO2EmissionsKg`	`number`		Nulable	-
`offerDataholdId`	`string`		Nulable	-
`offerDataoriginalCurrency`	`enum`	`EURUSDCNY`	Sí	-
`offerDatacurrency`	`enum`	`EURUSDCNY`	Sí	-

Notas operativas

Fresh offer detail availability depends on the selected source.
If direct offer detail is unavailable, keep the offer returned by public search and complete booking before it expires.
Reuse offerData.passengers[].id when creating the order. Do not send internal user identifiers.

Ejemplo

bash

curl https://api.sandbox.travelandz.com/v1/flights/offers/0/offer_123 \
  -H "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  -H "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE"