TUI Group Availability API
The availability API from TUI Group — 6 operation(s) for availability.
TUI Group Availability API is one of 113 APIs that TUI Group publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Availability. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.
This API exposes 6 operations across 6 paths, and defines 90 schemas. It is described by OpenAPI 3.2.0, at version 4.8.6.23.
Requests are made against 2 base URLs: https://prod.api.tui/flight/newskies/rest, https://playground.api.tui/flight/newskies/rest.
6 operations
6 paths
90 schemas
1 GET5 POST
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
TUI Group Availability API declares
1 security scheme
for authenticating requests.
It accepts HTTP bearer tokens (jwt) (JWT).
By default, every request must be authenticated.
JWT— Paste your JWT token from the token endpoint.
Paths & Operations 6
Across 6 paths, the API surfaces 6 operations — 1 GET, 5 POST. Each is listed below with its method, path, parameters, and response codes.
availability 6
POST
/api/nsk/v3/availability/lowfare
Searches for low fare availability with the full low fare search request. This request allows for total control over the configuration. If a property is not set, the default settings (LowFareAvailabi…
GET
/api/nsk/v1/availability/lowfare/estimate
Retrieves the low fare availability estimate using a range of dates.
POST
/api/nsk/v3/availability/lowfare/simple
Searches for low fare availability with the simple search request. The simple search request covers the common search criteria and lets default settings (LowFareAvailabilitySettings) configure the re…
POST
/api/nsk/v4/availability/search
Searches for availability with the full availability search request. This request allows for total control over the configuration. If a property is not set, default values will be set instead. These…
POST
/api/nsk/v4/availability/search/simple
Searches for availability with the simple availability search request. This request allows for easy setup for one way and round trip searches. If a property is not set, default values will be set ins…
POST
/api/nsk/v2/availability/search/ssr
Searches for availability with SSR prices with the full availability search request. This request allows for total control over the configuration. If a property is not set, default values will be set…
Schemas 90
The contract defines 90 schemas that model the data the API accepts and returns. The most detailed are LegInformation (30 properties), AvailabilityCriteriaFilter (18 properties), OperationsInformation (15 properties), FareAvailabilityv2 (13 properties). Each schema is shown below with its type and property counts.
AvailabilitySsrCollectionsMode
integer
SSR collection mode determines whethere SSR availability should be checked and returned on availability. 0 = None 1 = Leg
FareReference
object
The fare reference represents a master reference of the full fare details.
4 properties
IJsonResponseOfAvailabilityv2
object
Defines the JSON response contract.
3 properties
LowFareTripMarket
object
The low fare trip market represents a collection of markets.
1 property
BundleControlFilter
integer
Filter used to segregate the bundle information to return on flight availability. 0 = Disabled 1 = ReturnBundleSets 2 = ReturnBundleOffers
AvailabilityWithSsrResponse
object
Defines the trip availability with SSR response.
6 properties
LowFareEstimateByDate
object
The low fare availability for a given date.
7 properties
FareClassControl
integer
Fare class control enumeration for controlling the number and type of fares applied to the search response. 0 = LowestFareClass 1 = CompressByProductClass 2 =…
LowFarePassenger
object
Low fare passengers contains the passenger type specific data.
5 properties
PassengerFareAvailability
object
Model describing common fare availability information for an entire availability request.
11 properties
1 required
SoldAsConnectionType
integer
Enum to define if a connection is sold as domestic or international. 0 = None 1 = Domestic 2 = International 3 = Both
LowFareAvailabilityCodeCriteria
object
Describes the low fare availability code criteria.
3 properties
FareReferenceTotals
object
The fare reference totals represents the sum of all the fares for a specific available journey fare. If individual passenger fare breakdown in needed that will…
5 properties
NestType
integer
Nest type enumeration. 0 = Default 1 = Net 2 = Serial 3 = OneBooking
AvailableJourneyFareDetail
object
The available journey fare details represents a journeys fare availability.
6 properties
AvailabilityWithSsrPrice
object
This class contains an SSR and its possible prices with respect to each journey in the availability. Primarily used in GetTripAvailabilityWithSSR.
3 properties
Availabilityv2
object
Availabilityv2 represents the availability response based on the search criteria.
5 properties
CollectType
integer
Used to identify the collect type of a service charge. 0 = SellerChargeable 1 = ExternalChargeable 2 = SellerNonChargeable 3 = ExternalNonChargeable 4 = Extern…
OperationsInformation
object
Model describing the operations information.
15 properties
LowFareAmount
object
Low fare passengers contains the passenger type specific data.
3 properties
AvailabilitySimpleRequestv2
object
Model representing an availability simple request v2.
13 properties
4 required
TripResult
object
The trip results represents a wrapper class for the potential collection of multiple selected dates (flex days or range) selected on the availability request.
1 property
TripDateMarket
object
The trip date market represents a specific dates collection of markets.
4 properties
ChargeType
integer
The type of a service charge. 0 = FarePrice 1 = Discount 2 = IncludedTravelFee 3 = IncludedTax 4 = TravelFee 5 = Tax 6 = ServiceCharge 7 = PromotionDiscount 8…
AvailabilityCodeCriteriav2
object
Describes the different code criteria that can be set that can influence availability response.
4 properties
ServiceBundleType
integer
Defines the types for bundles. 0 = Included 1 = AddOn
AvailableJourney
object
The available journey represents a specific date, market journey that can be sold.
7 properties
BundleOffer
object
The bundle offer model.
3 properties
DayOfWeek
integer
Defines the day of the week with none as an option. 0 = None 1 = Monday 2 = Tuesday 3 = Wednesday 4 = Thursday 5 = Friday 6 = Saturday 7 = Sunday
AvailableSegment
object
Available segment represents an available segment on a available journey.
12 properties
PassengerSearchCriteriaDetail
object
Represents the passenger details for flight availability search.
5 properties
TransportationIdentifier
object
Represents the transportation identifier model data.
3 properties
2 required
JourneySortKey
integer
Defines the sorting keys for the journeys on availability. 0 = ServiceType 1 = ShortestTravelTime 2 = LowestFare 3 = HighestFare 4 = EarliestDeparture 5 = Late…
SsrPriceVariation
object
This class denotes a possible pricing of an SSR against the journeys of the availability. Primarily used in GetTripAvailabilityWithSSR.
4 properties
LowFareAvailabilityRequest
object
Defines the low are availability request.
7 properties
2 required
LowFareAvailabilityCriteria
object
Defines the low fare availability search criteria.
4 properties
3 required
AvailabilityDateCriteria
object
Defines the availability criteria dates.
5 properties
1 required
TaxesAndFeesRollupMode
integer
Indicates how "all-up" service charges will be rolled-up in the availability response. 0 = None 1 = Taxes 2 = TaxesAndFees
BundleProgramDetails
object
Represents the bundle program details model.
2 properties
FareStatus
integer
This enumeration defines the fare status of a passenger fare. 0 = Default 1 = SameDayStandBy 2 = FareOverrideConfirming 3 = FareOverrideConfirmed 4 = Published…
AvailabilityCriteria
object
Defines a single direction search criteria far an availability call.
4 properties
2 required
LowFare
object
Low fare contains the information for a specific flight.
9 properties
LegNest
object
A model representing a leg nest.
6 properties
LegClass
object
The leg class model information.
11 properties
1 required
LegStatus
integer
Leg status enumeration. 0 = Normal 1 = Closed 2 = Canceled 3 = Suspended 5 = ClosedPending 6 = BlockAllActivities 7 = Mishap
LowFareAvailabilitySearchSimpleRequest
object
Model representing a low fare availability search simple request.
10 properties
4 required
AvailabilityStationCriteria
object
Defines the availability criteria stations.
4 properties
2 required
Message
object
Defines a unique informational message.
5 properties
SegmentTypes
integer
Indicates the type of a segment. 0 = Normal 1 = CodeShareOperating 2 = CodeShareMarketing 3 = InterlineOutbound 4 = InterlineInbound 5 = Passive
PassengerTypeCriteria
object
Defines the availability criteria passenger types.
2 properties
1 required
ArrivalStatus
integer
Arrival status. 0 = Default 1 = Cancelled 2 = Arrived 3 = SeeAgent 4 = Delayed
IJsonResponse
object
Defines the JSON response contract for a not content type response.
3 properties
BundlePrice
object
The bundle price model.
7 properties
TransportationDesignator
object
Model information about the traveling arrival and destination details.
4 properties
AvailabilityCriteriaFilter
object
Defines all the different ways the availability response can be filtered.
18 properties
DepartureStatus
integer
Departure status. 0 = Default 1 = Cancelled 2 = Boarding 3 = SeeAgent 4 = Delayed 5 = Departed
LowFareLeg
object
Low fare leg information.
8 properties
IJsonResponseOfLowFareEstimateResults
object
Defines the JSON response contract.
3 properties
Exception
object
4 properties
LegSsr
object
A model representing a leg ssr summary.
5 properties
Leg
object
Model data describing the leg which is a single travel leg from point a to b.
8 properties
IJsonResponseOfAvailabilityWithSsrResponse
object
Defines the JSON response contract.
3 properties
AvailabilityType
integer
Availability type defines the type of fares to be returned. 0 = Default 1 = Standby 2 = Overbook 3 = NoPricing
LowFareAvailabilityFilterCriteria
object
Describes the low fare availability filtering criteria.
6 properties
FareAvailabilityv2
object
The fare availability represents a master fare reference with all the fare details.
13 properties
BundleSsrPrice
object
The bundle SSR price model.
4 properties
GateInformation
object
Represents the gate information for the trip status model. Consists of actual gate information and estimated/scheduled gate information.
2 properties
PassengerSearchCriteria
object
Model representing an passenger group type for availability search.
3 properties
2 required
AvailabilityWithSsrRequest
object
Defines the request to retrieve trip availability with SSR.
11 properties
2 required
LoyaltyFilter
integer
Availability loyalty filter enumeration for filtering the returning fares on availability. 0 = MonetaryOnly 1 = PointsOnly 2 = PointsAndMonetary 3 = PreserveCu…
LowFareFlightFilter
integer
Filter used to filter the types of availability to be returned for low fare. 0 = NoFlights 1 = AllFlights 2 = SelectedFlight
LowFareDateMarket
object
Low fare availability contains all information returned when requesting a low fare trip availability.
6 properties
DepartureEvent
object
Represents the flight operation times for the departure event, which includes an estimated and scheduled time event.
2 properties
AvailabilityFilter
integer
Filter used to filter the types of journeys to return on availability. 0 = Default 1 = ExcludeDeparted 2 = ExcludeImminent 3 = ExcludeUnavailable
FlightType
integer
Flight types enumeration. 0 = None 1 = NonStop 2 = Through 3 = Direct 4 = Connect 5 = All
ClassStatus
integer
Indicates whether a leg class may be used or not. 1 = Active 2 = InActive 3 = AvsOpen 4 = AvsOnRequest 5 = AvsClosed
MessageStatus
integer
Defines the message status. 0 = General 1 = Warning 2 = Critical
LowFareAvailabilityv2
object
Low fare availability contains all information returned when requesting a low fare trip availability.
3 properties
CodeShareIndicator
integer
Specifies the type of code share agreement. 0 = NonCodeShare 1 = CodeShareCommercialDuplicate 2 = SharedDesignatorOrWetLease 3 = CodeShareHostOperatingCarrier…
AvailabilityRequestv3
object
Defines the availability request, version 3.
8 properties
2 required
IJsonResponseOfLowFareAvailabilityv2
object
Defines the JSON response contract.
3 properties
LegInformation
object
Model describing the detailed leg information.
30 properties
ServiceCharge
object
Model that represents the fare service charge information.
9 properties
ErrorResponse
object
Defines a unique error response.
8 properties
FeePricingMode
integer
The fee pricing mode enumeration. 0 = MonetaryOnly 1 = PointsOnly
FareApplicationType
integer
This enumeration defines the fare application type of a fare. 0 = Route 1 = Sector 2 = Governing
LowFareEstimateResults
object
The low fare estimate results model.
1 property
PassengerSearchCriteriav2
object
Represents the passenger group type for availability search.
4 properties
2 required
AvailableJourneyFare
object
The available journey fare represents a journeys fare offering. If the journey is multi segment multiple fare details will be present so each fare can be shown…
3 properties
PassengerTypeCriteriav2
object
Defines the passenger type criteria for availability search.
2 properties
1 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from TUI Group 12
Other APIs TUI Group publishes across the network.
TUI Group Account API
TUI Group Airline Profile API
TUI Group Air Shopping API
TUI Group APIS Message API
TUI Group Apo API
TUI Group Auth API
TUI Group Baggage API
TUI Group Bag Tag API
TUI Group Boarding API
TUI Group Boarding Devices API
TUI Group Booking/addons API
TUI Group Booking API
#Availability
Where this information came from
This is an independent, third-party profile of TUI Group Availability API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.