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

Details zum Flugangebot abrufen

Retrieves the latest details for a selected flight offer before booking, including price, conditions, segments and passenger requirements when available.

Endpoint

Method	Path	Auth
`GET`	`/v1/flights/offers/:gdsprovider/:offerId`	Required API key

Required headers:

Header	Description
`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.

Request Params Schema

Property	Type	Details	Required	Notes
`gdsprovider`	`number`		Yes	-
`offerId`	`string`		Yes	-

Success Response

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

Response Body Schema

Property	Type	Details	Required	Notes
`offerData`	`object`		Yes	-
`offerDataofferId`	`string`		Yes	-
`offerDataofferLink`	`string`		Nullable	-
`offerDatagdsprovider`	`number`		Yes	-
`offerDataexpiresAt`	`string`	`Format: ISO 8601`	Yes	-
`offerDatatotalAmount`	`number`		Yes	-
`offerDataoriginalTotalAmount`	`number`		Yes	-
`offerDataholdOptions`	`object`		Yes	-
`offerDataholdOptionsavailable`	`boolean`		Yes	-
`offerDataholdOptionspaymentRequiredBy`	`string`	`Format: ISO 8601`	Nullable	-
`offerDataholdOptionspriceGuarantedUntil`	`string`	`Format: ISO 8601`	Nullable	-
`offerDatasupportedPassengerIdDocuments`	`array`		Yes	-
`offerDatasupportedPassengerIdDocuments[]`	`enum[]`		Yes	-

`offerDatapassengerIdentityDocumentsRequired`	`boolean`		Yes	-
`offerDatasupportedLoyaltyPrograms`	`array`		Yes	-
`offerDatasupportedLoyaltyPrograms[]`	`string[]`		Yes	-

`offerDataairline`	`object`		Yes	-
`offerDataairlinename`	`string`		Yes	-
`offerDataairlineiataCode`	`string`		Yes	-
`offerDataairlinelogoURL`	`string`		Nullable	-
`offerDataairlineconditionsOfCarriage`	`string`		No	-
`offerDatapassengers`	`array`		Yes	-
`offerDatapassengers[]id`	`string`		Yes	-
`offerDatapassengers[]type`	`enum`	`adultchildinfant_without_seat`	Yes	-

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

`offerDataCO2EmissionsKg`	`number`		Nullable	-
`offerDataholdId`	`string`		Nullable	-
`offerDataoriginalCurrency`	`enum`	`EURUSDCNY`	Yes	-
`offerDatacurrency`	`enum`	`EURUSDCNY`	Yes	-

Operational Notes

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.

Example

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"