POST/v1/flights/offers/:gdsprovider

Search provider flight offers

Searches flight offers in one specific source when an integration must target a single gdsprovider explicitly.

Endpoint

Method	Path	Auth
`POST`	`/v1/flights/offers/:gdsprovider`	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`	`enum`	`01`	Yes	Accepted values: `0`, `1`

Request Body Schema

Property	Type	Details	Required	Notes
`slices`	`array`		Yes	-
`slices[]origin`	`string`		Yes	IATA code of the origin airport or city
`slices[]destination`	`string`		Yes	IATA code of the destination airport or city
`slices[]departure_date`	`string`	`Format: YYYY-MM-DD`	Yes	Must not be in the past

`passengers`	`array`		Yes	-
`passengers[]type`	`enum`	`adultchildinfant_without_seat`	Yes	-

`cabin_class`	`enum`	`economybusinessfirstpremium_economy`	Yes	-
`currency`	`enum`	`EURUSDCNY`	No	Default EUR
`retrieveBookingLink`	`boolean`		No	When true, supported offers can include offerLink
`includeOriginalPrice`	`boolean`		No	-
`language`	`enum`	`eneszh`	No	Optional language for translated metadata when available

Success Response

Returns offers[] from the selected provider.

Response Body Schema

Property	Type	Details	Required	Notes
`offers`	`array`		Yes	-
`offers[]offerId`	`string`		Yes	-
`offers[]offerLink`	`string`		Nullable	-
`offers[]gdsprovider`	`number`		Yes	-
`offers[]expiresAt`	`string`	`Format: ISO 8601`	Yes	-
`offers[]totalAmount`	`number`		Yes	-
`offers[]originalTotalAmount`	`number`		Yes	-
`offers[]holdOptions`	`object`		Yes	-
`offers[]holdOptionsavailable`	`boolean`		Yes	-
`offers[]holdOptionspaymentRequiredBy`	`string`	`Format: ISO 8601`	Nullable	-
`offers[]holdOptionspriceGuarantedUntil`	`string`	`Format: ISO 8601`	Nullable	-
`offers[]supportedPassengerIdDocuments`	`array`		Yes	-
`offers[]supportedPassengerIdDocuments[]`	`enum[]`		Yes	-

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

`offers[]airline`	`object`		Yes	-
`offers[]airlinename`	`string`		Yes	-
`offers[]airlineiataCode`	`string`		Yes	-
`offers[]airlinelogoURL`	`string`		Nullable	-
`offers[]airlineconditionsOfCarriage`	`string`		No	-
`offers[]passengers`	`array`		Yes	-
`offers[]passengers[]id`	`string`		Yes	-
`offers[]passengers[]type`	`enum`	`adultchildinfant_without_seat`	Yes	-

`offers[]conditions`	`object`		Yes	-
`offers[]conditionsrefundBeforeDeparture`	`object`		Yes	-
`offers[]conditionsrefundBeforeDeparturecurrency`	`string`		Yes	-
`offers[]conditionsrefundBeforeDeparturepenaltyAmount`	`string`		Yes	-
`offers[]conditionsrefundBeforeDepartureallowed`	`boolean`		Yes	-
`offers[]conditionschangeBeforeDeparture`	`object`		Yes	-
`offers[]conditionschangeBeforeDeparturecurrency`	`string`		Yes	-
`offers[]conditionschangeBeforeDeparturepenaltyAmount`	`string`		Yes	-
`offers[]conditionschangeBeforeDepartureallowed`	`boolean`		Yes	-
`offers[]slices`	`array`		Yes	-
`offers[]slices[]fareName`	`string`		Yes	-
`offers[]slices[]departure`	`object`		Yes	-
`offers[]slices[]departureiataCode`	`string`		Yes	-
`offers[]slices[]departurecityName`	`string`		Yes	-
`offers[]slices[]departureairportName`	`string`		No	-
`offers[]slices[]departuredepartingAt`	`string`	`Format: ISO 8601`	Yes	-
`offers[]slices[]departuretimeZone`	`string`		No	-
`offers[]slices[]arrival`	`object`		Yes	-
`offers[]slices[]arrivaliataCode`	`string`		Yes	-
`offers[]slices[]arrivalcityName`	`string`		Yes	-
`offers[]slices[]arrivalairportName`	`string`		No	-
`offers[]slices[]arrivalarrivingAt`	`string`	`Format: ISO 8601`	Yes	-
`offers[]slices[]arrivaltimeZone`	`string`		No	-
`offers[]slices[]durationMinutes`	`number`		Yes	-
`offers[]slices[]conditions`	`object`		Yes	-
`offers[]slices[]conditionspriorityCheckIn`	`boolean`		Yes	-
`offers[]slices[]conditionspriorityBoarding`	`boolean`		Yes	-
`offers[]slices[]conditionsadvanceSeatSelection`	`boolean`		Yes	-
`offers[]slices[]segments`	`array`		Yes	-
`offers[]slices[]segments[]fareName`	`string`		Yes	-
`offers[]slices[]segments[]departure`	`object`		Yes	-
`offers[]slices[]segments[]departureiataCode`	`string`		Yes	-
`offers[]slices[]segments[]departurecityName`	`string`		Yes	-
`offers[]slices[]segments[]departureairportName`	`string`		No	-
`offers[]slices[]segments[]departuredepartingAt`	`string`	`Format: ISO 8601`	Yes	-
`offers[]slices[]segments[]departuretimeZone`	`string`		No	-
`offers[]slices[]segments[]departureterminal`	`string`		No	-
`offers[]slices[]segments[]arrival`	`object`		Yes	-
`offers[]slices[]segments[]arrivaliataCode`	`string`		Yes	-
`offers[]slices[]segments[]arrivalcityName`	`string`		Yes	-
`offers[]slices[]segments[]arrivalairportName`	`string`		No	-
`offers[]slices[]segments[]arrivalarrivingAt`	`string`	`Format: ISO 8601`	Yes	-
`offers[]slices[]segments[]arrivaltimeZone`	`string`		No	-
`offers[]slices[]segments[]arrivalterminal`	`string`		No	-
`offers[]slices[]segments[]airline`	`object`		Yes	-
`offers[]slices[]segments[]airlineoperatingCarrier`	`object`		Yes	-
`offers[]slices[]segments[]airlineoperatingCarriername`	`string`		Yes	-
`offers[]slices[]segments[]airlineoperatingCarrieriataCode`	`string`		Yes	-
`offers[]slices[]segments[]airlineoperatingCarrierlogoURL`	`string`		Nullable	-
`offers[]slices[]segments[]airlineoperatingCarrierconditionsOfCarriage`	`string`		No	-
`offers[]slices[]segments[]airlinemarketingCarrier`	`object`		Yes	-
`offers[]slices[]segments[]airlinemarketingCarriername`	`string`		Yes	-
`offers[]slices[]segments[]airlinemarketingCarrieriataCode`	`string`		Yes	-
`offers[]slices[]segments[]airlinemarketingCarrierlogoURL`	`string`		Nullable	-
`offers[]slices[]segments[]airlinemarketingCarrierconditionsOfCarriage`	`string`		No	-
`offers[]slices[]segments[]flightNumber`	`string`		Yes	-
`offers[]slices[]segments[]durationMinutes`	`number`		Yes	-
`offers[]slices[]segments[]passengers`	`array`		Yes	-
`offers[]slices[]segments[]passengers[]amenities`	`object`		Yes	-
`offers[]slices[]segments[]passengers[]amenitieswifi`	`object`		Yes	-
`offers[]slices[]segments[]passengers[]amenitieswificost`	`enum`	`freefree or paidpaid`	Nullable	-
`offers[]slices[]segments[]passengers[]amenitieswifiavailable`	`boolean`		Yes	-
`offers[]slices[]segments[]passengers[]amenitiesseat`	`object`		Yes	-
`offers[]slices[]segments[]passengers[]amenitiesseatpitch`	`enum`	`"number"n/a`	Yes	-
`offers[]slices[]segments[]passengers[]amenitiesseatlegroom`	`enum`	`lessmorestandardn/a`	Yes	-
`offers[]slices[]segments[]passengers[]amenitiesseattype`	`enum`	`standardskycouchreclinerangle_flatfull_flatfull_flat_podprivate_suite`	Nullable	-
`offers[]slices[]segments[]passengers[]amenitiespower`	`boolean`		Yes	-
`offers[]slices[]segments[]passengers[]baggages`	`array`		Yes	-
`offers[]slices[]segments[]passengers[]baggages[]type`	`enum`	`checkedcarry_on`	Yes	-
`offers[]slices[]segments[]passengers[]baggages[]quantity`	`number`		Yes	-
`offers[]slices[]segments[]passengers[]baggages[]maxKg`	`string`		No	-

`offers[]CO2EmissionsKg`	`number`		Nullable	-
`offers[]holdId`	`string`		Nullable	-
`offers[]originalCurrency`	`enum`	`EURUSDCNY`	Yes	-
`offers[]currency`	`enum`	`EURUSDCNY`	Yes	-

Operational Notes

Use this endpoint only when the integration must force a provider. The response shape matches the public flight search response.

Example

bash

curl -X POST https://api.sandbox.travelandz.com/v1/flights/offers/0 \
  -H "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  -H "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE" \
  -H "Content-Type: application/json" \
  -d '{"slices":[{"origin":"MAD","destination":"BCN","departure_date":"2026-08-20"}],"passengers":[{"type":"adult"}],"cabin_class":"economy","currency":"EUR"}'