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

Get flight offer detail

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 details of flights offer

Response Body Schema

Property	Type	Details	Required	Notes
`offerData`	`object`		Yes	-
`offerId`	`string`		Yes	-
`offerLink`	`string`		Nullable	-
`gdsprovider`	`number`		Yes	-
`expiresAt`	`string`	`Format: ISO 8601`	Yes	-
`totalAmount`	`number`		Yes	-
`originalTotalAmount`	`number`		Yes	-
`holdOptions`	`object`		Yes	-
`holdOptions` `available`	`boolean`		Yes	-
`holdOptions` `paymentRequiredBy`	`string`	`Format: ISO 8601`	Nullable	-
`holdOptions` `priceGuarantedUntil`	`string`	`Format: ISO 8601`	Nullable	-
`supportedPassengerIdDocuments`	`array`		Yes	-
`supportedPassengerIdDocuments[]`	`enum[]`		Yes	-

`passengerIdentityDocumentsRequired`	`boolean`		Yes	-
`supportedLoyaltyPrograms`	`array`		Yes	-
`supportedLoyaltyPrograms[]`	`string[]`		Yes	-

`airline`	`object`		Yes	-
`airline` `name`	`string`		Yes	-
`airline` `iataCode`	`string`		Yes	-
`airline` `logoURL`	`string`		Nullable	-
`airline` `conditionsOfCarriage`	`string`		No	-
`passengers`	`array`		Yes	-
`id`	`string`		Yes	-
`type`	`enum`	`adult`, `child`, `infant_without_seat`	Yes	-

`conditions`	`object`		Yes	-
`conditions` `refundBeforeDeparture`	`object`		Yes	-
`conditions` `refundBeforeDeparture` `currency`	`string`		Yes	-
`conditions` `refundBeforeDeparture` `penaltyAmount`	`string`		Yes	-
`conditions` `refundBeforeDeparture` `allowed`	`boolean`		Yes	-
`conditions` `changeBeforeDeparture`	`object`		Yes	-
`conditions` `changeBeforeDeparture` `currency`	`string`		Yes	-
`conditions` `changeBeforeDeparture` `penaltyAmount`	`string`		Yes	-
`conditions` `changeBeforeDeparture` `allowed`	`boolean`		Yes	-
`slices`	`array`		Yes	-
`fareName`	`string`		Yes	-
`departure`	`object`		Yes	-
`iataCode`	`string`		Yes	-
`cityName`	`string`		Yes	-
`airportName`	`string`		No	-
`departingAt`	`string`	`Format: ISO 8601`	Yes	-
`timeZone`	`string`		No	-
`arrival`	`object`		Yes	-
`iataCode`	`string`		Yes	-
`cityName`	`string`		Yes	-
`airportName`	`string`		No	-
`arrivingAt`	`string`	`Format: ISO 8601`	Yes	-
`timeZone`	`string`		No	-
`durationMinutes`	`number`		Yes	-
`conditions`	`object`		Yes	-
`priorityCheckIn`	`boolean`		Yes	-
`priorityBoarding`	`boolean`		Yes	-
`advanceSeatSelection`	`boolean`		Yes	-
`segments`	`array`		Yes	-
`fareName`	`string`		Yes	-
`departure`	`object`		Yes	-
`iataCode`	`string`		Yes	-
`cityName`	`string`		Yes	-
`airportName`	`string`		No	-
`departingAt`	`string`	`Format: ISO 8601`	Yes	-
`timeZone`	`string`		No	-
`terminal`	`string`		No	-
`arrival`	`object`		Yes	-
`iataCode`	`string`		Yes	-
`cityName`	`string`		Yes	-
`airportName`	`string`		No	-
`arrivingAt`	`string`	`Format: ISO 8601`	Yes	-
`timeZone`	`string`		No	-
`terminal`	`string`		No	-
`airline`	`object`		Yes	-
`operatingCarrier`	`object`		Yes	-
`operatingCarrier` `name`	`string`		Yes	-
`operatingCarrier` `iataCode`	`string`		Yes	-
`operatingCarrier` `logoURL`	`string`		Nullable	-
`operatingCarrier` `conditionsOfCarriage`	`string`		No	-
`marketingCarrier`	`object`		Yes	-
`marketingCarrier` `name`	`string`		Yes	-
`marketingCarrier` `iataCode`	`string`		Yes	-
`marketingCarrier` `logoURL`	`string`		Nullable	-
`marketingCarrier` `conditionsOfCarriage`	`string`		No	-
`flightNumber`	`string`		Yes	-
`durationMinutes`	`number`		Yes	-
`passengers`	`array`		Yes	-
`amenities`	`object`		Yes	-
`wifi`	`object`		Yes	-
`wifi` `cost`	`enum`	`free`, `free or paid`, `paid`	Nullable	-
`wifi` `available`	`boolean`		Yes	-
`seat`	`object`		Yes	-
`seat` `pitch`	`enum`	`"number"`, `n/a`	Yes	-
`seat` `legroom`	`enum`	`less`, `more`, `standard`, `n/a`	Yes	-
`seat` `type`	`enum`	`standard`, `skycouch`, `recliner`, `angle_flat`, `full_flat`, `full_flat_pod`, `private_suite`	Nullable	-
`power`	`boolean`		Yes	-
`baggages`	`array`		Yes	-
`type`	`enum`	`checked`, `carry_on`	Yes	-
`quantity`	`number`		Yes	-
`maxKg`	`string`		No	-

`CO2EmissionsKg`	`number`		Nullable	-
`holdId`	`string`		Nullable	-
`originalCurrency`	`enum`	`EUR`, `USD`, `CNY`	Yes	-
`currency`	`enum`	`EUR`, `USD`, `CNY`	Yes	-