How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

TUI Group Trip API

The trip API from TUI Group — 38 operation(s) for trip.

TUI Group Trip 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 Trip. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 43 operations across 38 paths, and defines 274 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.

43 operations 38 paths 274 schemas 3 DELETE10 GET2 PATCH18 POST10 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
4.8.6.23
Base URL
https://prod.api.tui/flight/newskies/rest
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

TUI Group Trip 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 43

Across 38 paths, the API surfaces 43 operations — 3 DELETE, 10 GET, 2 PATCH, 18 POST, 10 PUT. Each is listed below with its method, path, parameters, and response codes.

trip 43
POST
/api/nsk/v5/trip
Creates a new booking with the provided journeys, contacts, passengers, and SSRs.
nsk_v5_trip_post 1 param body → 201400
POST
/api/nsk/v4/tripdeprecated
Creates a new booking with the provided journeys, contacts, passengers, and SSRs.
nsk_v4_trip_post body → 201400409
GET
/api/nsk/v1/trip/{legKey}/seats/{unitKey}/properties
BETA - Retrieves inventory seat properties for a given flight leg and unit key.
nsk_v1_trip_legKey_seats_unitKey_properties_get 3 params → 200400
POST
/api/nsk/v1/trip/{legKey}/seats/{unitKey}/properties
BETA - Creates an inventory seat property for a given flight leg and unit key.
nsk_v1_trip_legKey_seats_unitKey_properties_post 2 params body → 201400
PUT
/api/nsk/v1/trip/{legKey}/seats/{unitKey}/properties
BETA - Updates an inventory seat property for a given flight leg and unit key.
nsk_v1_trip_legKey_seats_unitKey_properties_put 2 params body → 200400
DELETE
/api/nsk/v1/trip/{legKey}/seats/{unitKey}/properties
BETA - Deletes an inventory seat property for a given flight leg and unit key.
nsk_v1_trip_legKey_seats_unitKey_properties_delete 2 params body → 200400
GET
/api/nsk/v1/trip/{legKey}/seats/properties
BETA - Retrieves inventory seat properties for a given flight leg.
nsk_v1_trip_legKey_seats_properties_get 2 params → 200400
POST
/api/nsk/v1/trip/contacts
Creates a new contacts-only booking.
nsk_v1_trip_contacts_post body → 200400
POST
/api/nsk/v2/trip/info
Gets the search results for the trip information, based on the search criteria.
nsk_v2_trip_info_post body → 200404
GET
/api/nsk/v1/trip/info/{legKey}/details
Retrieves cabin and various details for the specified leg key.
nsk_v1_trip_info_legKey_details_get 1 param → 200404
PATCH
/api/nsk/v1/trip/info/{legKey}/status
Stateless operation for updating the trip information status for a specific flight.
nsk_v1_trip_info_legKey_status_patch 1 param body → 200400500
GET
/api/nsk/v2/trip/info/{legKey}/status
Retrieves the trip status data for the specified leg key.
nsk_v2_trip_info_legKey_status_get 1 param → 200404
POST
/api/nsk/v1/trip/info/{legKey}/status/comments
Stateless operation for creating operation comments in the trip information status for a specific flight.
nsk_v1_trip_info_legKey_status_comments_post 1 param body → 201400
PUT
/api/nsk/v1/trip/info/{legKey}/status/comments/{commentKey}
Stateless operation for updating the operation comments in the trip information status for a specific flight.
nsk_v1_trip_info_legKey_status_comments_commentKey_put 2 params body → 200400500
DELETE
/api/nsk/v1/trip/info/{legKey}/status/comments/{commentKey}
Stateless operation for deleting the operation comments in the trip information status for a specific flight.
nsk_v1_trip_info_legKey_status_comments_commentKey_delete 2 params → 200400500
POST
/api/nsk/v1/trip/info/{legKey}/status/delays
Stateless operation for creating operation delays in the trip information status for a specific flight.
nsk_v1_trip_info_legKey_status_delays_post 1 param body → 201400
PATCH
/api/nsk/v1/trip/info/{legKey}/status/delays/{delayKey}
Stateless operation for patching the operation delays in the trip information status for a specific flight.
nsk_v1_trip_info_legKey_status_delays_delayKey_patch 2 params body → 200400500
DELETE
/api/nsk/v1/trip/info/{legKey}/status/delays/{delayKey}
Stateless operation for deleting trip operation delays in the trip information status for a specific flight.
nsk_v1_trip_info_legKey_status_delays_delayKey_delete 2 params → 200400500
PUT
/api/nsk/v1/trip/info/{legKey}/status/operationDetails/status/cancel
Updates the leg status to cancel.
nsk_v1_trip_info_legKey_status_operationDetails_status_cancel_put 1 param → 200400
PUT
/api/nsk/v1/trip/info/{legKey}/status/operationDetails/status/closeLegdeprecated
Updates a leg status closed.
nsk_v1_trip_info_legKey_status_operationDetails_status_closeLeg_put 3 params → 200400
PUT
/api/nsk/v2/trip/info/{legKey}/status/operationDetails/status/closeLeg
Updates a leg status closed.
nsk_v2_trip_info_legKey_status_operationDetails_status_closeLeg_put 1 param body → 200400
PUT
/api/nsk/v1/trip/info/{legKey}/status/operationDetails/status/closePendingLeg
Updates a leg status to closed pending.
nsk_v1_trip_info_legKey_status_operationDetails_status_closePendingLeg_put 2 params → 200400
PUT
/api/nsk/v1/trip/info/{legKey}/status/operationDetails/status/mishap
Secures all passenger information associated with the flight leg clearing and locking the passenger data. This changes the leg status to Mishap.
nsk_v1_trip_info_legKey_status_operationDetails_status_mishap_put 1 param → 200400401
PUT
/api/nsk/v1/trip/info/{legKey}/status/operationDetails/status/mishapRestoredeprecated
Restores locked passenger data associated with the flight leg. This restores the leg status to normal.
nsk_v1_trip_info_legKey_status_operationDetails_status_mishapRestore_put 1 param → 200400401
PUT
/api/nsk/v1/trip/info/{legKey}/status/operationDetails/status/openLeg
Updates a leg status to open.
nsk_v1_trip_info_legKey_status_operationDetails_status_openLeg_put 3 params → 200400
PUT
/api/nsk/v1/trip/info/{legKey}/status/operationDetails/status/restore
Updates the leg status to normal.
nsk_v1_trip_info_legKey_status_operationDetails_status_restore_put 1 param → 200400
POST
/api/nsk/v2/trip/info/legs
Searches for the inventory legs based on the search criteria.
nsk_v2_trip_info_legs_post body → 200404
GET
/api/nsk/v2/trip/info/legs/simple
Performs a simplified search for trip information by leg, based upon minimal, required data for the search criteria.
nsk_v2_trip_info_legs_simple_get 8 params → 200404
GET
/api/nsk/v2/trip/info/simple
Performs a simplified search for trip information based upon minimal, required data for the search criteria.
nsk_v2_trip_info_simple_get 10 params → 200404
POST
/api/nsk/v1/trip/info/status/operationDetails/status/mishapRestore
Restores locked passenger data associated the leg information. This restores the leg status to normal.
nsk_v1_trip_info_status_operationDetails_status_mishapRestore_post body → 200400401
POST
/api/nsk/v2/trip/move
Moves a journey on the booking in state.
nsk_v2_trip_move_post body → 201400403409500
POST
/api/nsk/v3/trip/move/availability
Searches for move availability with the full availability search request. This request will allow for total control over the configuration. If a property is not set, the default settings (Availabilit…
nsk_v3_trip_move_availability_post body → 200400403404
GET
/api/nsk/v3/trip/move/availability/{journeyKey}
Searches for availability with the simple move request. The simple search request covers the bare minimum search criteria and lets default settings (AvailabilitySettings) configure the rest.
nsk_v3_trip_move_availability_journeyKey_get 5 params → 200404
GET
/api/nsk/v2/trip/move/availability/selfService
Self-service search for move availability.
nsk_v2_trip_move_availability_selfService_get 2 params → 200404
POST
/api/nsk/v1/trip/move/irop
Performs an IROP move for the booking in state. This endpoint adds additional IROP move functionality for agents. See /api/nsk/v2/trip/move for IROP functionality not restricted to agents only.
nsk_v1_trip_move_irop_post body → 201
POST
/api/nsk/v1/trip/passengers
Creates a new booking with the provided passengers.
nsk_v1_trip_passengers_post 1 param body → 201404409400
POST
/api/nsk/v1/trip/passiveSegments
Creates a passive segment and creates a booking if it doesn't already exist.
nsk_v1_trip_passiveSegments_post body → 200404409
POST
/api/nsk/v5/trip/rebook/availability
Rebook search with the current booking defaults.
nsk_v5_trip_rebook_availability_post body → 200404
GET
/api/nsk/v4/trip/rebook/availability/simple
Simple rebook search with the current booking defaults.
nsk_v4_trip_rebook_availability_simple_get 5 params → 200404
GET
/api/nsk/v1/trip/schedule
Retrieves the schedule of flights for a market.
nsk_v1_trip_schedule_get 5 params → 200
POST
/api/nsk/v1/trip/schedule/adHoc
Creates an ad hoc flight.
nsk_v1_trip_schedule_adHoc_post body → 201
POST
/api/nsk/v4/trip/sell
Sells the list of journeys and creates a booking if it doesn't already exist.
nsk_v4_trip_sell_post body → 200400404409
POST
/api/nsk/v1/trip/standby/availability
Retrieves same-day standby availability relevant to the current state booking.
nsk_v1_trip_standby_availability_post body → 200404

Schemas 274

The contract defines 274 schemas that model the data the API accepts and returns. The most detailed are LegInformation (30 properties), PassengerSegment (29 properties), Order (28 properties), Payment (28 properties). Each schema is shown below with its type and property counts.

EmdTypeCode
integer
Represents the EMD type code options. 0 = None 1 = Associated 2 = StandAlone
QueueMode
integer
Determines where a queue request is coming from. 0 = EnQueued 1 = DeQueued
MovePassengerJourneyType
integer
The type of move to perform for the passengers on the journey. 0 = None 1 = Irop 2 = Diversion 4 = FlightClose 5 = FlyAhead 6 = SplitJourney 7 = SelfServiceReb…
PaymentAttachment
object
Defines a payment attachment.
3 properties
TripOperationPayload
object
Represents the payload data for the trip operation.
4 properties
AvailabilitySsrCollectionsMode
integer
SSR collection mode determines whethere SSR availability should be checked and returned on availability. 0 = None 1 = Leg
PassengerProgram
object
Model representing a passenger program.
3 properties
BookingPassengerRequest
object
Defines the the passenger and associated ssr request.
3 properties 1 required
AuthenticationStatus
integer
Defines the different possible payment authentication statuses for 3DS. 0 = Unknown 1 = AuthenticationSuccessful 2 = AuthenticationFailed 3 = AuthenticationCou…
Passenger
object
Model information representing a passenger on a journey.
15 properties 1 required
IJsonResponseOfAvailabilityv2
object
Defines the JSON response contract.
3 properties
OperationCounts
object
Represents the operation counts model.
12 properties
AvailabilityMoveFilterCriteria
object
Filter criteria filters the move availability responses results.
2 properties
MoveSsrOption
integer
How to handle SSRs on move. 0 = OverbookSsr 1 = MoveAvailableSsr 2 = MoveNone
BookingOrder
object
Represents a booking order.
7 properties
TripContactsRequest
object
Trip contacts request represents the data needed to sell a contacts-only booking.
1 property 1 required
Availabilityv2
object
Availabilityv2 represents the availability response based on the search criteria.
5 properties
OrderFeeType
integer
Defines the travel commerce fee types. 0 = Default 1 = Tax 2 = Markup 3 = Discount
DeltaMapperOfTripOperationDelayEditRequest
object
Map delta changes of a specific type T to another object.
3 properties
BundleControlFilter
integer
Filter used to segregate the bundle information to return on flight availability. 0 = Disabled 1 = ReturnBundleSets 2 = ReturnBundleOffers
GssStayType
integer
The type of stay type. 0 = None 1 = Vacation 2 = Business 3 = Duty
IJsonResponseOfIListOfTripInformationResponsev2
object
Defines the JSON response contract.
3 properties
AmountDue
object
Defines the amounts due for an order.
3 properties
AddOnOrderSummary
object
Defines the details about an order if the order is not available.
11 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 =…
PassengerPriceBreakdown
object
Defines the individual passenger-level pricing breakdown.
10 properties
InputedParameter
object
Defines a parameter with data input.
3 properties
SeatPreference
object
Represents a single seat preference.
3 properties 2 required
Fare
object
Model describing a fare.
22 properties
HistoryCategory
integer
Represents the various history report types. 0 = Unknown 1 = Baggage 2 = BagTagPrint 3 = BoardingPassPrint 4 = CheckIn 5 = ClassOfServiceChange 6 = Comment 7 =…
IJsonResponseOfTripStatusv2
object
Defines the JSON response contract.
3 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
PassengerVoucherCustomerProgram
object
Defines the passenger voucher customer program.
2 properties
NestType
integer
Nest type enumeration. 0 = Default 1 = Net 2 = Serial 3 = OneBooking
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
AvailableJourneyFareDetail
object
The available journey fare details represents a journeys fare availability.
6 properties
TripOperationDelayCreateRequest
object
Represents a delay for a trip operation.
4 properties 2 required
PassengerEmdCoupon
object
Model information for the passenger EMD coupon.
14 properties
ReceivedByInfo
object
Defines the received by information.
5 properties
CollectType
integer
Used to identify the collect type of a service charge. 0 = SellerChargeable 1 = ExternalChargeable 2 = SellerNonChargeable 3 = ExternalNonChargeable 4 = Extern…
PassengerFare
object
Model that represents the passenger fare details.
5 properties 1 required
OrderFee
object
Defines a order fee.
10 properties
OperationsInformation
object
Model describing the operations information.
15 properties
PaymentAmounts
object
Defines the different applied payment amounts for a single payment.
6 properties
BookingProfileStatus
integer
Defines the profiling status of the booking. 0 = Default 1 = KnownIndividual 2 = ResolutionGroup 3 = SelecteeGroup 4 = NotUsed 5 = FailureGroup 6 = RandomSelec…
QueueAction
integer
Specifies the basics by which a queue filter was created. 0 = Default 1 = Warning 2 = Lock 3 = DefaultAndNotify 4 = WarningAndNotify 5 = LockAndNotify
TripOperationCommentEditRequest
object
Represents a comment for a trip operation.
1 property 1 required
TripInformationQuery
object
The trip information query model contains data to perform a trip information search.
15 properties 1 required
Order
object
Defines a order.
28 properties
PassengerSegment
object
Model data for the passenger on the booking for the specific segment.
29 properties
ItinerarySegment
object
Represents the operation between board station and any subsequent off station within the same flight.
7 properties
IJsonResponseOfTripDetails
object
Defines the JSON response contract.
3 properties
PaymentMethodType
integer
Defines the payment method types. 0 = ExternalAccount 1 = PrePaid 2 = AgencyAccount 3 = CustomerAccount 4 = Voucher 5 = Loyalty
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
BookingHold
object
Defines the booking hold expiration.
1 property
OperationsFlightType
integer
Flight types enumeration for operations and schedules. 0 = All 1 = NonStop 2 = Through 3 = Direct 4 = Connect
ProductTypeCode
integer
Defines the different travel commerce types. 0 = Default 1 = Insurance 2 = Activity 3 = Hotel 4 = Car
CreatedAddOnDetails
object
Defines a component details.
6 properties
PassengerPriceBreakdownBase
object
Defines the combined booking passengers pricing breakdown.
9 properties
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
TripSellRequestv2
object
Defines the data needed to sell journeys to a booking.
11 properties 2 required
BookingHistory
object
Defines a booking history log entry.
8 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
ContactRequest
object
Defines a contact create request.
10 properties
BundleOffer
object
The bundle offer model.
3 properties
Booking
object
Represents a full booking object.
22 properties
QueueEventType
integer
Describes the different queue event types. 0 = Default 1 = BookingBalanceDue 2 = BookingNegativeBalance 3 = BookingCustomerComment 4 = DeclinedPaymentInitial 5…
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
ChangeReasonCodes
integer
Specifies the reason code on why the change on the journey or segment is performed. 0 = NoChange 1 = Irop 2 = ScheduleChange 3 = Move 4 = VoluntaryFlyAhead 5 =…
TripInformationJourneyv2
object
Represents the trip information journey.
3 properties
AuthorizationStatus
integer
Defines the different possible payment authorization states. 0 = Unknown 1 = Acknowledged 2 = Pending 3 = InProcess 4 = Approved 5 = Declined 6 = Referral 7 =…
AvailableSegment
object
Available segment represents an available segment on a available journey.
12 properties
PaidStatus
integer
Paid status enumeration. 0 = UnderPaid 1 = PaidInFull 2 = OverPaid
TripInformationResponsev2
object
A collection of journeys for a given departure date and market.
2 properties
TripInformationLegv2
object
Represents the trip information leg model.
6 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
IJsonResponseOfIListOfTripInformationLegv2
object
Defines the JSON response contract.
3 properties
TripInformationStatusRequestBase
object
Represents the base trip information status request model.
12 properties
JourneySortKey
integer
Defines the sorting keys for the journeys on availability. 0 = ServiceType 1 = ShortestTravelTime 2 = LowestFare 3 = HighestFare 4 = EarliestDeparture 5 = Late…
InventoryControlType
integer
Defines the different ways inventory is held at the time of sell. 0 = HoldSpace 1 = SoftHoldSpace 2 = ClaimSpace 3 = OversellSpace 4 = StandBy
ParticipantDocument
object
Defines a consumer document.
3 properties
ItineraryVariation
object
Defines the schedule itinerary variation.
2 properties 2 required
TicketStatusCode
integer
This enumeration defines the ticket availability status. 0 = Unknown 1 = TicketAvailableForUse 2 = TicketUnavailableForUse 3 = TicketReissueRequiredForPassenge…
BookingPaymentStatus
integer
Determines if the booking has been paid for or not. 0 = New 1 = Received 2 = Pending 3 = Approved 4 = Declined 5 = Unknown 6 = PendingCustomerAction
PassengerSeat
object
Model for a passenger seat for a segment.
11 properties
TravelClassSeatPreference
integer
Represents a travel class seating preference. 0 = None 1 = Business 2 = Economy 3 = FirstClass
AddOn
object
Defines a booking add on service details.
15 properties
SegmentStatus
integer
The segment status. 0 = UnknownStatus 1 = UnableToConfirmSegment 2 = UnableToSellSegment 3 = HeldPending 4 = WaitListConfirmed 5 = HeldUnconfirmed 6 = HeldConf…
JourneyPriceBreakdownBase
object
Defines the journey price breakdown base.
4 properties
TypeOfSale
object
Defines the type of sale values.
3 properties
PassengerSsr
object
The model for a passengers Ssr details.
13 properties
TripLoyaltyFilter
integer
Trip loyalty filter enumeration for selling journeys on a booking. 0 = MonetaryOnly 1 = PointsOnly 2 = PointsAndMonetary
ChargeBreakdown
object
Defines a charge breakdown.
4 properties
OrderLocation
object
Defines a location.
4 properties 2 required
AvailabilityDateCriteria
object
Defines the availability criteria dates.
5 properties 1 required
Gender
integer
Defines the different binary gender types. 0 = XX 1 = Male 2 = Female
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
AvailabilityCriteria
object
Defines a single direction search criteria far an availability call.
4 properties 2 required
FareStatus
integer
This enumeration defines the fare status of a passenger fare. 0 = Default 1 = SameDayStandBy 2 = FareOverrideConfirming 3 = FareOverrideConfirmed 4 = Published…
IJsonResponseOfBooking
object
Defines the JSON response contract.
3 properties
FeeType
integer
Enumeration representing all the different fee types. 0 = All 1 = Tax 2 = TravelFee 3 = ServiceFee 4 = PaymentFee 5 = PenaltyFee 6 = SsrFee 7 = NonFlightServic…
TripFuelDetails
object
Represents the fuel information for a trip.
3 properties
AvailabilityFlightCriteria
object
The specific flight criteria for the availability criteria.
4 properties
PaymentVoucherDetails
object
Payment voucher details. This describes a voucher applied to a payment.
5 properties
LegNest
object
A model representing a leg nest.
6 properties
ItineraryLeg
object
Defines a single instance of non-stop travel between two stations.
2 properties
IJsonResponseOfIListOfScheduleDetail
object
Defines the JSON response contract.
3 properties
FareReference
object
The fare reference represents a master reference of the full fare details.
4 properties
LegClass
object
The leg class model information.
11 properties 1 required
DirectCurrencyConversion
object
Defines a direct currency conversion.
7 properties
FareDesignator
object
Model describing the fare designator information.
1 property
LegStatus
integer
Leg status enumeration. 0 = Normal 1 = Closed 2 = Canceled 3 = Suspended 5 = ClosedPending 6 = BlockAllActivities 7 = Mishap
DestinationDetails
object
Represents the destination details model.
5 properties
TripOperationEvents
object
Represents the flight operation time events for an estimated, actual, and forced time event.
3 properties
IropMoveRequest
object
Defines the irop move request for a booking.
9 properties 3 required
AvailabilityStationCriteria
object
Defines the availability criteria stations.
4 properties 2 required
Infant
object
Model representing an infant.
6 properties
PhoneNumberType
integer
Defines the types of phone numbers. Note: New Skies does not support Mobile for booking contacts. 0 = Other 1 = Home 2 = Work 3 = Mobile 4 = Fax
SeatPreferences
object
Represents the seating preferences base model.
3 properties
AddOnPriceBreakdown
object
Defines the addOn price breakdown.
3 properties
PassengerRequest
object
Defines the passenger request details.
9 properties 1 required
Contact
object
Contact model describing a person contact information.
11 properties 1 required
PriceStatus
integer
Describes the fare pricing status 0 = Invalid 1 = Override 2 = Valid
TripDetails
object
Represents the trip status details version two model.
3 properties
BookingPointOfSale
object
Model related to the point of sale.
6 properties
LegCrossReference
object
Represents the inventory leg cross reference data.
3 properties
Message
object
Defines a unique informational message.
5 properties
AvailabilityRebookRequestv3
object
Model representing an availability rebook search.
5 properties 1 required
Payment
object
Defines an applied payment on the booking.
28 properties
SegmentTypes
integer
Indicates the type of a segment. 0 = Normal 1 = CodeShareOperating 2 = CodeShareMarketing 3 = InterlineOutbound 4 = InterlineInbound 5 = Passive
AddOnDetails
object
Defines a booking add on base details.
4 properties
MarketInformation
object
Model information about the market arrival and destination details.
4 properties 4 required
OrderParticipant
object
Defines a orders participant.
14 properties
ArrivalStatus
integer
Arrival status. 0 = Default 1 = Cancelled 2 = Arrived 3 = SeeAgent 4 = Delayed
InventorySeatPropertyBase
object
Represents the base inventory seat property to be committed.
2 properties 2 required
ChannelType
integer
Defines the available channel types doing invoking the communication with the server. 0 = Default 1 = Direct 2 = Web 3 = Gds 4 = Api 5 = DigitalApi 6 = Digital…
OrderCriteria
object
Defines a products order criteria.
11 properties
BookingHistoryEvent
integer
Represents the different events that trigger an entry into the schedule history. 0 = Unknown 1 = ConvertedHistory 2 = FlightTimeChange 3 = FlightDesignatorChan…
PassengerVoucherUsageType
integer
Passenger voucher usage type specifies what parts of a booking this voucher can pay for. 0 = None 1 = Fares 2 = Taxes 3 = TravelFees 4 = ServiceFees 5 = Penalt…
AddOnCharge
object
Defines a booking add ons charge.
7 properties
DistributionOption
integer
This enumeration specifies the distribution methods for sending notifications. 0 = None 1 = Mail 2 = Email 3 = Fax 4 = MailFax 5 = Airport 6 = Hold 7 = Print
TripOperationTimes
object
Represents the flight operation time events. Null property values indicate that there is no recorded time event for the given property name.
13 properties
IJsonResponse
object
Defines the JSON response contract for a not content type response.
3 properties
OrderHistory
object
Defines a order history transaction.
5 properties
PassengerFee
object
Model representing passenger fee information.
16 properties 1 required
OverbookIndicatorTypes
integer
Specifies the type of code share agreement. 0 = NormalSell 1 = Oversold 2 = ClassOrCabinOversold
IgnoreLiftStatus
integer
Defines the lift status ignore level for Journey Move/Cancel. 0 = IgnoreNotAllowed 1 = IgnoreCheckin 2 = IgnoreBoarded
ThreeDSecure
object
Defines three D secure.
24 properties
BundlePrice
object
The bundle price model.
7 properties
JourneySellRequest
object
Journey request represents the trip sell request but with only information needed for a booking sell.
3 properties 1 required
PassiveSegmentRequest
object
Passive segment request represents the data that will be added as a passive segment on a booking.
9 properties 7 required
OperationDetails
object
Represents the operation details model.
12 properties
Coordinate
object
The defined coordinates of a location.
2 properties
LiftStatus
integer
Lift status enumeration. 0 = Default 1 = CheckedIn 2 = Boarded 3 = NoShow
BaggageStatus
integer
Baggage Status enumeration. 0 = Default 1 = Checked 2 = Removed 3 = Added 4 = AddedPrinted
OrderCustomer
object
Defines an order customer contact details.
11 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
TripOperationCommentCreateRequest
object
Represents the create request for a comment for a trip operation.
2 properties 1 required
DepartureStatus
integer
Departure status. 0 = Default 1 = Cancelled 2 = Boarding 3 = SeeAgent 4 = Delayed 5 = Departed
EquipmentFilter
object
Represents a filter for equipment type.
2 properties 1 required
Exception
object
4 properties
BookingStatus
integer
Booking Status Enumeration 0 = Default 1 = Hold 2 = Confirmed 3 = Closed 4 = HoldCanceled 5 = PendingArchive 6 = Archived 7 = ArchivedPrivate 777 = ProcessedFo…
PassengerInformation
object
Represents additional passenger information.
6 properties
JourneyPriceBreakdown
object
Defines a specifics journey pricing breakdown.
5 properties
CommitItineraryVariationRequest
object
Defines the commit itinerary variation request.
2 properties
LegSsr
object
A model representing a leg ssr summary.
5 properties
ProductVariationDetail
object
Defines a products variation detail.
3 properties
PassengerVoucher
object
Defines a passenger voucher.
6 properties
OnTime
integer
Represents the likelihood of a leg being on time. 0 = Above0Percent 1 = Above10Percent 2 = Above20Percent 3 = Above30Percent 4 = Above40Percent 5 = Above50Perc…
PhoneNumber
object
Defines a common phone number.
2 properties 2 required
Leg
object
Model data describing the leg which is a single travel leg from point a to b.
8 properties
PassengerTravelDocument
object
Model representing a passenger travel document.
14 properties 1 required
SeatInfo
object
The model for the seat information such as deck, seat properties, etc.
3 properties
WeightCategory
integer
Defines the categories of adults by gender or specifies the passenger as a child. This is used for balance determinations. 0 = Undefined 1 = Male 2 = Female 3…
LegSeatsSold
object
Represents the leg seats sold model.
5 properties
Segment
object
Segment model for an already booked flight.
23 properties
DirectCurrencyConversionStatus
integer
Enumeration that determines the status of a DCC authorization. 0 = DccNotOffered 1 = DccOfferRejected 2 = DccOfferAccepted 3 = DccInitialValue 4 = MccInUse
OrderPayment
object
Defines a payment on an order.
13 properties 1 required
TripOperationComment
object
Represents a comment for a trip operation.
7 properties
Name
object
Defines a common name.
5 properties
ApisAddressStatus
integer
Defines what type of APIS requirement is the address. 0 = Residence 1 = InCountry 2 = Emergency 3 = Contact
OrderAddress
object
Defines an address with GPS coordinates.
8 properties
PassengerBag
object
Model information about the passenger's baggage.
11 properties
AvailabilityType
integer
Availability type defines the type of fares to be returned. 0 = Default 1 = Standby 2 = Overbook 3 = NoPricing
PassengerScore
object
Defines a passenger score.
3 properties 1 required
PointOfSale
object
Model related to the point of sale. This is for read-only operations.
4 properties
TripInformationLegQuery
object
The trip information leg query model contains data to perform a trip information search.
12 properties 1 required
BookingComment
object
Defines a booking comment.
5 properties
Address
object
Defines a common address.
7 properties
LegDetailsv2
object
Represents the leg details model.
26 properties
TicketIndicatorCode
integer
This enumeration defines the ticket requirements 0 = Unknown 1 = TicketRequired 2 = AutomatedTicketLiftRequired 3 = ManualTicketLiftRequired 4 = AutomatedTicke…
PaymentAction
integer
Defines payment action that should be taken by selling system for this service. 1 = SellingSystemCollects 2 = PassThroughHold 3 = NoPaymentRequired 4 = ReferTo…
BookingPriceBreakdown
object
Defines the booking top level pricing breakdown.
13 properties
TripOperationCrew
object
Represents the crew of an trip operation.
2 properties
FareAvailabilityv2
object
The fare availability represents a master fare reference with all the fare details.
13 properties
CommentType
integer
Comment Types Enumerations 0 = Default 1 = Itinerary 2 = Manifest 3 = Alert 4 = Archive 5 = Voucher
Term
object
Defines the terms and conditions of an order.
3 properties
NotificationPreference
integer
Describes types of notifications the user would prefer. 0 = None 1 = Promotional
GateInformation
object
Represents the gate information for the trip status model. Consists of actual gate information and estimated/scheduled gate information.
2 properties
BundleSsrPrice
object
The bundle SSR price model.
4 properties
PassengerAddress
object
Passenger address information. This contains more data then the base address class.
15 properties
InboundOutbound
integer
This enumeration specifies direction of flight application. 0 = None 1 = Inbound 2 = Outbound 3 = Both 4 = RoundFrom 5 = RoundTo
BookingSales
object
Defines the different point of sale information.
3 properties
BookingInfo
object
Describes general booking details.
16 properties
AvailabilityMoveRequest
object
Defines the availability move request.
7 properties 3 required
AddOnStatus
integer
An enumeration to indicate the add on's current status. 0 = Unknown 1 = Active 2 = Pending 3 = Confirming 4 = CancelPending 5 = Cancelled
InfantFee
object
Defines the infant fee information.
12 properties 1 required
OriginDetails
object
Represents the origin details model.
4 properties
LoyaltyFilter
integer
Availability loyalty filter enumeration for filtering the returning fares on availability. 0 = MonetaryOnly 1 = PointsOnly 2 = PointsAndMonetary 3 = PreserveCu…
ChallengePreference
integer
Defines the challenge preference. 0 = NoPreference 1 = NoChallengeRequested 2 = ChallengeRequested 3 = ChallengeMandated
WeightType
integer
Weight Type enumeration. 0 = Default 1 = Pounds 2 = Kilograms
FlightCloseRequest
object
Options for flight close
8 properties
SsrDurationType
integer
Ssr duration type. 0 = Segment 1 = Journey 2 = Leg
BookingSellRequest
object
Trip sell request represents the data needed to sell journeys to a booking.
10 properties 2 required
BookingQueueInfo
object
Describes the booking queue info.
14 properties
PaymentDetails
object
Defines the payment details.
9 properties
RecordLocator
object
Defines a unique locator for reference.
7 properties
OperationCommentType
integer
The operation comment type enumeration. 0 = Default 1 = Reservation 2 = Operation 3 = PitLoad 4 = Irop 5 = AppsOverride 6 = ManualAppsOverride
SellKey
object
Sell key represents the journey and the fare sell keys to combine to what journey and fare will be sold.
4 properties 2 required
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
PassengerTypeCriteriav2
object
Defines the passenger type criteria for availability search.
2 properties 1 required
Ticket
object
Model for a ticket applied to a passenger.
5 properties
ConsumerAddress
object
Defines a consumer address.
8 properties
IJsonResponseOfIListOfItineraryVariation
object
Defines the JSON response contract.
3 properties
ScheduleDetail
object
Market detail contains the abstracted market data describing the earliest and latest STD.
4 properties
OrderPriceBreakdown
object
Defines all the different order price breakdown.
18 properties
ClassStatus
integer
Indicates whether a leg class may be used or not. 1 = Active 2 = InActive 3 = AvsOpen 4 = AvsOnRequest 5 = AvsClosed
TravelDocumentCreateRequest
object
Defines a create travel documents request.
13 properties 1 required
PassengerSegmentBag
object
Model information about the baggage a passenger has on a segment.
6 properties 3 required
PassengerInfant
object
Model representing an infant with a passenger.
9 properties
SimpleSeatPreference
integer
Represents a simple seating preference. 0 = None 1 = Window 2 = Aisle 3 = Other
CrewType
integer
Defines the different types of crew members. 0 = Default 1 = Pilot 2 = CoPilot 3 = CockpitJumpseat 4 = CabinJumpseat 5 = CabinCrew
BookingRecordLocators
object
Defines the booking's unique identifiers.
4 properties
OptionalServiceInformation
object
Represents the optional service information model.
2 properties
MessageStatus
integer
Defines the message status. 0 = General 1 = Warning 2 = Critical
TripOperationHistory
object
Represents the history of an trip operation.
4 properties
EmdCouponStatus
integer
Represents the EMD coupon status options. 0 = Unknown 1 = HeldConfirmed 2 = HoldingNeed 3 = HoldingConfirmedEmdRequired 4 = HoldingConfirmedEmdIssued
PassengerBoardingPassDetail
object
Defines information used to populate the printed boarding pass and 2D bar codes.
7 properties
Amount
object
Defines an amount base price and total price.
2 properties
IropInventoryControlType
integer
Defines the different ways inventory is held at the time of sell for an irop move. 0 = ClaimSpace 1 = OversellSpace 2 = StandBy
OrderNote
object
Defines a order note.
4 properties
CodeShareIndicator
integer
Specifies the type of code share agreement. 0 = NonCodeShare 1 = CodeShareCommercialDuplicate 2 = SharedDesignatorOrWetLease 3 = CodeShareHostOperatingCarrier…
TripOperationDelay
object
Represents the trip operation delay data.
9 properties 2 required
IJsonResponseOfIDictionaryOfStringAndListOfInventorySeatPropertyBase
object
Defines the JSON response contract.
3 properties
LegInformation
object
Model describing the detailed leg information.
30 properties
ScheduleItineraryLeg
object
Defines the itinerary leg for creating flights.
11 properties 5 required
OperatingInformation
object
Represents the operating information model.
4 properties
TripPassengerCountsEditRequest
object
The number of passengers and crew in the flight.
5 properties
ServiceCharge
object
Model that represents the fare service charge information.
9 properties
AvailabilityStandbyRequest
object
Standby availability request.
4 properties 1 required
ErrorResponse
object
Defines a unique error response.
8 properties
Journey
object
Data about the journey which represents the collection of segments and their legs on the journey.
7 properties
FareApplicationType
integer
This enumeration defines the fare application type of a fare. 0 = Route 1 = Sector 2 = Governing
JourneyMove
object
Summarized move data at the journey level.
2 properties
MoveRequestv2
object
Defines the move journey request for a booking in state.
11 properties 3 required
JourneySsrRequest
object
SSR request for a single journey Ssr.
4 properties 2 required
PassengerSearchCriteriav2
object
Represents the passenger group type for availability search.
4 properties 2 required
SeatPreferenceStatus
integer
Defines the seat preference status. 0 = Unknown 1 = Met 2 = NotMet
TripOperationTimesEditRequest
object
Represents the edit request for flight operation time events.
12 properties
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
ApplyServiceBundle
integer
The apply service bundle enumeration. 0 = Yes 1 = No 2 = Copy
ChallengePreferenceWindowSize
integer
Defines the challenge preference window size. 0 = SizeFullPage 1 = Size250X400 2 = Size390X400 3 = Size500X600 4 = Size600X400
CabinDetails
object
Represents the cabin details model.
4 properties
TripStatusv2
object
Represents the trip status version two model.
8 properties
BookingOrderStatus
integer
Booking Order Status Enumeration 0 = None 1 = FinalizedProcess

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tui-group-trip-api-openapi.yml Raw ↑

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 Availability API
TUI Group Baggage API
TUI Group Bag Tag API
TUI Group Boarding API
TUI Group Boarding Devices API
TUI Group Booking/addons API
Where this information came from

This is an independent, third-party profile of TUI Group Trip 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.