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 Booking API

The booking API from TUI Group — 53 operation(s) for booking.

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

This API exposes 69 operations across 53 paths, and defines 258 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.

69 operations 53 paths 258 schemas 13 DELETE23 GET2 PATCH17 POST14 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 Booking 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 69

Across 53 paths, the API surfaces 69 operations — 13 DELETE, 23 GET, 2 PATCH, 17 POST, 14 PUT. Each is listed below with its method, path, parameters, and response codes.

booking 69
GET
/api/nsk/v1/booking
Get the current booking in state.
nsk_v1_booking_get → 200400409
POST
/api/nsk/v3/booking
Commits stateful changes made and processes the booking.
nsk_v3_booking_post body → 201403409400
PUT
/api/nsk/v3/booking
Commits stateful changes made and processes the booking.
nsk_v3_booking_put 1 param body → 200400500409
GET
/api/nsk/v1/booking/baggageAllowances
Gets the baggage allowances for the current booking in state. Baggage usage details will only be returned if includeUsageDetails is flagged true AND the allowance behavior is NOT Default.
nsk_v1_booking_baggageAllowances_get 1 param → 200404
POST
/api/nsk/v1/booking/baggageAllowances/external
Gets the third-party baggage allowance calculations for the current booking in state.
nsk_v1_booking_baggageAllowances_external_post body → 200404
POST
/api/nsk/v1/booking/bundle/availability
Retrieves the bundle and ssr availability for the booking in-state.
nsk_v1_booking_bundle_availability_post body → 404200
GET
/api/nsk/v1/booking/comments
Gets the list of comments on the in-state booking.
nsk_v1_booking_comments_get → 200404
DELETE
/api/nsk/v2/booking/comments/{commentKey}
Deletes a comment from the booking.
nsk_v2_booking_comments_commentKey_delete 1 param → 200409
POST
/api/nsk/v2/booking/divide
Divides the current booking.
nsk_v2_booking_divide_post body → 201200400403409
GET
/api/nsk/v2/booking/equipment/legs/{legKey}
Retrieves equipment information for a specified leg.
nsk_v2_booking_equipment_legs_legKey_get 1 param → 200404
GET
/api/nsk/v2/booking/equipment/legs/{legKey}/properties
Retrieves equipment, supported seat property and seat-dependent SSR information for a specified leg.
nsk_v2_booking_equipment_legs_legKey_properties_get 1 param → 200404
GET
/api/nsk/v2/booking/equipment/segments/{segmentKey}
Retrieves equipment information for all legs on a specified segment.
nsk_v2_booking_equipment_segments_segmentKey_get 1 param → 200404
GET
/api/nsk/v2/booking/equipment/segments/{segmentKey}/properties
Retrieves equipment, supported seat property and seat-dependent SSR information for all legs on a specified segment.
nsk_v2_booking_equipment_segments_segmentKey_properties_get 1 param → 200404
POST
/api/nsk/v2/booking/eTickets
BETA - Issues new e-tickets and re-issues existing e-tickets for segments with voluntary changes.
nsk_v2_booking_eTickets_post → 201502
PUT
/api/nsk/v2/booking/eTickets
BETA - Re-issues existing e-tickets for segments with involuntary changes such as schedule change and IROP.
nsk_v2_booking_eTickets_put → 200502
POST
/api/nsk/v1/booking/eTickets
Issues new e-tickets and re-issues existing e-tickets for segments with voluntary changes.
nsk_v1_booking_eTickets_post → 201502409
PUT
/api/nsk/v1/booking/eTickets
Re-issues existing e-tickets for segments with involuntary changes such as schedule change and IROP.
nsk_v1_booking_eTickets_put → 200502409
POST
/api/nsk/v1/booking/eTickets/forceIssue
BETA - Forces issuance of new e-tickets when re-issuance is not allowed by the ticketing service.
nsk_v1_booking_eTickets_forceIssue_post → 201400502
GET
/api/nsk/v1/booking/eTickets/validation
Checks if the booking in state is valid for e-ticketing operations.
nsk_v1_booking_eTickets_validation_get → 200
POST
/api/nsk/v1/booking/fareOverride/journey/{journeyKey}
Replaces an existing fare price with an amount specified.
nsk_v1_booking_fareOverride_journey_journeyKey_post 1 param body → 201400403409
GET
/api/nsk/v2/booking/fareRules
Retrieves the collection of all fare rules from the current booking in state.
nsk_v2_booking_fareRules_get 1 param → 200404
POST
/api/nsk/v2/booking/fareRules/category50/journeys/{journeyKey}/segments/{segmentKey}
Get the category 50 fare rule information for a specific segment on a booking.
nsk_v2_booking_fareRules_category50_journeys_journeyKey_segments_segmentKey_post 4 params → 200400404
GET
/api/nsk/v1/booking/fareRules/fare/{fareKey}
Retrieves a fare rule from the current booking in state based on the specific fare key.
nsk_v1_booking_fareRules_fare_fareKey_get 2 params → 200404
GET
/api/nsk/v2/booking/fareRules/journey/{journeyKey}
Retrieves the collection of all fare rules from the current booking in state for the specific journey key.
nsk_v2_booking_fareRules_journey_journeyKey_get 2 params → 200404
GET
/api/nsk/v2/booking/fareRules/segment/{segmentKey}
Retrieves the collection of all fare rules from the current booking in state for the specific segment key.
nsk_v2_booking_fareRules_segment_segmentKey_get 2 params → 200404
GET
/api/nsk/v1/booking/fee
Gets the fee price.
nsk_v1_booking_fee_get 5 params → 200404
POST
/api/nsk/v1/booking/fee
Manually adds a new fee.
nsk_v1_booking_fee_post body → 201409
PUT
/api/nsk/v1/booking/fee/{feeKey}
Overrides a fee amount.
nsk_v1_booking_fee_feeKey_put 1 param body → 200409
DELETE
/api/nsk/v1/booking/fee/{feeKey}
Deletes a fee.
nsk_v1_booking_fee_feeKey_delete 1 param → 200409
PUT
/api/nsk/v1/booking/fees
Overrides multiple fee amounts.
nsk_v1_booking_fees_put body → 200409
GET
/api/nsk/v1/booking/fees/{feeKey}/quote
Gets the override fee quote of an existing fee.
nsk_v1_booking_fees_feeKey_quote_get 3 params → 200400404
DELETE
/api/nsk/v1/booking/fees/penalty
Waives the penalty fee of all journeys in the booking.
nsk_v1_booking_fees_penalty_delete → 200409
DELETE
/api/nsk/v1/booking/fees/spoilage
Waives the spoilage fee of all journeys in the booking.
nsk_v1_booking_fees_spoilage_delete → 200409
PUT
/api/nsk/v1/booking/groupNamedeprecated
Changes the group name of the booking in state.
nsk_v1_booking_groupName_put 1 param → 200404409
DELETE
/api/nsk/v1/booking/groupName
Deletes the group name of the booking in state.
nsk_v1_booking_groupName_delete → 200409
PUT
/api/nsk/v2/booking/groupName
Changes the group name of the booking in state.
nsk_v2_booking_groupName_put body → 200500409
GET
/api/nsk/v2/booking/hold/available
Retrieves the recommended hold date if hold is available.
nsk_v2_booking_hold_available_get → 200404409
GET
/api/nsk/v1/booking/indiaGstRegistrationRequirement
Returns true if it is expected to prompt the user for India GST registration details.
nsk_v1_booking_indiaGstRegistrationRequirement_get → 200404
GET
/api/nsk/v1/booking/info
Gets the details of the current booking in state.
nsk_v1_booking_info_get → 200400409
POST
/api/nsk/v1/booking/itinerary/print
Sends the booking itinerary notification to the specified printer. Automatically commits uncommitted changes to the state booking before queuing the booking to a print notification queue.
nsk_v1_booking_itinerary_print_post body → 202400409
GET
/api/nsk/v1/booking/penalties
Gets the booking penalty from the booking in state.
nsk_v1_booking_penalties_get → 200404
DELETE
/api/nsk/v1/booking/penalties/{cancelledJourneyKey}
Waives the penalty fees of the specified cancelled journey.
nsk_v1_booking_penalties_cancelledJourneyKey_delete 1 param → 200409
PUT
/api/nsk/v1/booking/pointOfSale
Updates the booking point of sale.
nsk_v1_booking_pointOfSale_put body → 200500409
PATCH
/api/nsk/v1/booking/pointOfSale
Updates the booking point of sale.
nsk_v1_booking_pointOfSale_patch body → 200500409
POST
/api/nsk/v1/booking/prepaidExternal
Creates a new prepaid external payment on the booking in state.
nsk_v1_booking_prepaidExternal_post 1 param body → 201409
PUT
/api/nsk/v1/booking/price
Applies fares, discounts and taxes to the booking in state.
nsk_v1_booking_price_put body → 200404409
GET
/api/nsk/v1/booking/price/validation
Validates the fare prices on the booking in state.
nsk_v1_booking_price_validation_get → 200400
POST
/api/nsk/v1/booking/promotion
Sets a promotion code to a booking in state.
nsk_v1_booking_promotion_post body → 201400409
PUT
/api/nsk/v1/booking/promotion
Updates a promotion code to a booking in state.
nsk_v1_booking_promotion_put body → 200400409
DELETE
/api/nsk/v1/booking/promotion
Deletes the promotion code on the booking in state.
nsk_v1_booking_promotion_delete → 200400409
POST
/api/nsk/v3/booking/queue
Adds the booking from state to a booking queue.
nsk_v3_booking_queue_post body → 200400
POST
/api/nsk/v2/booking/queuedeprecated
Adds the booking from state to a booking queue.
nsk_v2_booking_queue_post body → 200500409
DELETE
/api/nsk/v2/booking/queue
Removes the booking in state from a booking queue.
nsk_v2_booking_queue_delete body → 200409
DELETE
/api/nsk/v1/booking/queues/{bookingQueueKey}
Removes the booking in state from the specified booking queue item.
nsk_v1_booking_queues_bookingQueueKey_delete 1 param body → 200409
GET
/api/nsk/v1/booking/recordLocators
Gets all of the record locators on the in-state booking.
nsk_v1_booking_recordLocators_get → 200404
POST
/api/nsk/v1/booking/recordLocators
Adds a third party record locator to the booking.
nsk_v1_booking_recordLocators_post body → 201409
DELETE
/api/nsk/v1/booking/recordLocators
Deletes all record locators from the booking.
nsk_v1_booking_recordLocators_delete → 200409
GET
/api/nsk/v1/booking/recordLocators/{recordLocatorKey}
Gets the record locator associated with the record locator key for the in-state booking.
nsk_v1_booking_recordLocators_recordLocatorKey_get 1 param → 200404
PUT
/api/nsk/v1/booking/recordLocators/{recordLocatorKey}
Replaces the data of a third party record locator on the booking.
nsk_v1_booking_recordLocators_recordLocatorKey_put 1 param body → 200500409
PATCH
/api/nsk/v1/booking/recordLocators/{recordLocatorKey}
Patches the data of a third party record locator on the booking.
nsk_v1_booking_recordLocators_recordLocatorKey_patch 1 param body → 200500409
DELETE
/api/nsk/v1/booking/recordLocators/{recordLocatorKey}
Deletes a record locator from the booking.
nsk_v1_booking_recordLocators_recordLocatorKey_delete 1 param → 200409
PUT
/api/nsk/v1/booking/reinstate
Reinstates a booking with a status of hold canceled.
nsk_v1_booking_reinstate_put → 200400404500409
DELETE
/api/nsk/v1/booking/reset
Clears the current booking state.
nsk_v1_booking_reset_delete → 200409
PUT
/api/nsk/v1/booking/salesChannel
Overrides the effective sales channel for the booking in state.
nsk_v1_booking_salesChannel_put 1 param → 200500409
GET
/api/nsk/v2/booking/status
Gets the status of the booking commit and returns the booking.
nsk_v2_booking_status_get → 200202409
PUT
/api/nsk/v1/booking/systemCode
Updates the system code of the state booking.
nsk_v1_booking_systemCode_put body → 200500409
DELETE
/api/nsk/v1/booking/systemCode
Removes the system code of the state booking.
nsk_v1_booking_systemCode_delete → 200500409
GET
/api/nsk/v1/booking/validation
Evaluates the booking in state prior to commit or payment processing.
nsk_v1_booking_validation_get → 200404
POST
/api/nsk/v1/booking/verifiedTravelDocuments/segments/{segmentKey}/passengers/{passengerKey}
Adds a new verified travel document to a passenger or the associated infant.
nsk_v1_booking_verifiedTravelDocuments_segments_segmentKey_passengers_passengerKey_post 2 params body → 201400

Schemas 258

The contract defines 258 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
PaymentAttachment
object
Defines a payment attachment.
3 properties
PenaltyType
integer
Enumeration representing all the different penalty types. 0 = None 1 = WithFee 2 = NonRefundable
PrintItineraryRequest
object
Defines the print itinerary request model.
2 properties 1 required
EquipmentBasev2
object
Represents the basic equipment information response model.
7 properties
BookingPenalty
object
Defines booking penalty.
1 property
GetOverrideFeeQuoteResponse
object
Defines the get override fee quote response.
1 property
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
PassengerProgram
object
Model representing a passenger program.
3 properties
IJsonResponseOfIListOfFareRule
object
Defines the JSON response contract.
3 properties
BookingOrder
object
Represents a booking order.
7 properties
OrderFeeType
integer
Defines the travel commerce fee types. 0 = Default 1 = Tax 2 = Markup 3 = Discount
Equipmentv2
object
Represents the equipment information response model.
9 properties
ExternalBaggageAllowanceCarryOnDetail
object
External baggage allowance information details for carry-on baggage.
7 properties
IJsonResponseOfCommitBookingResponse
object
Defines the JSON response contract.
3 properties
BundleJourneySsr
object
Model information for a bundle sell service request (SSR) tied to a specific journey.
13 properties
GssStayType
integer
The type of stay type. 0 = None 1 = Vacation 2 = Business 3 = Duty
ExternalBaggageAllowanceCarryOnCharge
object
Charge details under each external baggage allowance information item for carry-on baggage.
1 property
DeltaMapperOfRecordLocatorEditRequest
object
Map delta changes of a specific type T to another object.
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
PaymentMethodRequest
object
Defines a request to apply payment to the booking in state.
7 properties 2 required
IJsonResponseOfBoolean
object
Defines the JSON response contract.
3 properties
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 =…
FeeRequest
object
Defines the request to retrieve a service fee.
3 properties 2 required
BaggageAllowance
object
Defines a baggage allowance.
11 properties
PassengerVoucherCustomerProgram
object
Defines the passenger voucher customer program.
2 properties
IJsonResponseOfIssueETicketResponse
object
Defines the JSON response contract.
3 properties
NestType
integer
Nest type enumeration. 0 = Default 1 = Net 2 = Serial 3 = OneBooking
FareRule
object
Defines a fare rule and its data.
2 properties
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
BookingProfileStatus
integer
Defines the profiling status of the booking. 0 = Default 1 = KnownIndividual 2 = ResolutionGroup 3 = SelecteeGroup 4 = NotUsed 5 = FailureGroup 6 = RandomSelec…
PaymentAmounts
object
Defines the different applied payment amounts for a single payment.
6 properties
QueueAction
integer
Specifies the basics by which a queue filter was created. 0 = Default 1 = Warning 2 = Lock 3 = DefaultAndNotify 4 = WarningAndNotify 5 = LockAndNotify
Order
object
Defines a order.
28 properties
SsrType
integer
SsrType enumeration. 0 = Standard 1 = Infant 2 = Meal 3 = BaggageAllowance 4 = TravelLineMeal
PassengerSegment
object
Model data for the passenger on the booking for the specific segment.
29 properties
PaymentMethodType
integer
Defines the payment method types. 0 = ExternalAccount 1 = PrePaid 2 = AgencyAccount 3 = CustomerAccount 4 = Voucher 5 = Loyalty
FeeApplication
integer
Enumeration representing how and where fees are to be applied. 0 = Pnr 1 = TravelComponent 2 = EachPassenger 3 = EachPassengerTravelComponent 4 = SpecifyPassen…
IJsonResponseOfIListOfEquipmentv2
object
Defines the JSON response contract.
3 properties
BookingHold
object
Defines the booking hold expiration.
1 property
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
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…
BaggageAllowanceBehavior
integer
Baggage allowance behavior enumeration. 0 = Default 1 = WeightSharing 2 = PerPiece 3 = PerPieceWithWeightSharing 4 = NotAvailable
BookingHistory
object
Defines a booking history log entry.
8 properties
IJsonResponseOfEquipmentv2
object
Defines the JSON response contract.
3 properties
ServiceBundleType
integer
Defines the types for bundles. 0 = Included 1 = AddOn
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…
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 =…
AuthorizationStatus
integer
Defines the different possible payment authorization states. 0 = Unknown 1 = Acknowledged 2 = Pending 3 = InProcess 4 = Approved 5 = Declined 6 = Referral 7 =…
PaidStatus
integer
Paid status enumeration. 0 = UnderPaid 1 = PaidInFull 2 = OverPaid
BaggageUsageDetails
object
Defines baggage usage details.
4 properties
TransportationIdentifier
object
Represents the transportation identifier model data.
3 properties 2 required
BookingPaymentTransfer
object
Defines a booking payment transfer transaction
2 properties
ParticipantDocument
object
Defines a consumer document.
3 properties
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
TypeOfSale
object
Defines the type of sale values.
3 properties
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
PassengerSsr
object
The model for a passengers Ssr details.
13 properties
BundlePriceAvailability
object
The bundle price availability model.
10 properties
SeatMapProperty
object
Defines a property of a equipment unit.
2 properties
RecordLocatorEditRequest
object
The record locator edit request model.
3 properties
ChargeBreakdown
object
Defines a charge breakdown.
4 properties
IJsonResponseOfExternalBaggageAllowanceResponse
object
Defines the JSON response contract.
3 properties
OrderLocation
object
Defines a location.
4 properties 2 required
Gender
integer
Defines the different binary gender types. 0 = XX 1 = Male 2 = Female
PromotionRequest
object
Defines the simple request to apply a promotion code.
2 properties 1 required
BundlePricesByJourney
object
The bundle prices by journey model.
2 properties
SeatRestriction
integer
The seat restriction enumeration. 0 = Undefined 1 = AlwaysAllowed 2 = DefaultAllowed 3 = DefaultRestricted
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…
UpgradableSsrAvailability
object
The upgradable bundle ssr availability model.
10 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…
IJsonResponseOfBooking
object
Defines the JSON response contract.
3 properties
IJsonResponseOfIListOfServiceCharge
object
Defines the JSON response contract.
3 properties
IJsonResponseOfBookingInfov2
object
Defines the JSON response contract.
3 properties
PenaltyFeeTypeInfo
object
Defines penalty fee type info.
3 properties
BookingQueueRequestv2
object
The booking queue request v2 model.
3 properties 1 required
PaymentVoucherDetails
object
Payment voucher details. This describes a voucher applied to a payment.
5 properties
IJsonResponseOfNullableDateTime
object
Defines the JSON response contract.
3 properties
LegNest
object
A model representing a leg nest.
6 properties
IssueETicketResponse
object
The response from issuing an e-ticket.
1 property
LegClass
object
The leg class model information.
11 properties 1 required
DirectCurrencyConversion
object
Defines a direct currency conversion.
7 properties
IJsonResponseOfIListOfRecordLocator
object
Defines the JSON response contract.
3 properties
LegStatus
integer
Leg status enumeration. 0 = Normal 1 = Closed 2 = Canceled 3 = Suspended 5 = ClosedPending 6 = BlockAllActivities 7 = Mishap
IJsonResponseOfBookingValidationResponse
object
Defines the JSON response contract.
3 properties
FareDesignator
object
Model describing the fare designator information.
1 property
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
PenaltyFeeType
integer
Enumeration representing all the different penalty fee types. 0 = None 1 = Change 2 = Cancel 3 = Move
PriceStatus
integer
Describes the fare pricing status 0 = Invalid 1 = Override 2 = Valid
BookingPointOfSale
object
Model related to the point of sale.
6 properties
SeatPreferences
object
Represents the seating preferences base model.
3 properties
AddOnPriceBreakdown
object
Defines the addOn price breakdown.
3 properties
Contact
object
Contact model describing a person contact information.
11 properties 1 required
IncludedSsrAvailability
object
The included ssr availability model.
8 properties
BundleLegSsr
object
Model information for a bundle sell service request (SSR) tied to a specific leg.
13 properties
Message
object
Defines a unique informational message.
5 properties
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
OrderCriteria
object
Defines a products order criteria.
11 properties
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…
PriceRequest
object
Defines price request.
4 properties
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
BookingHistoryEvent
integer
Represents the different events that trigger an entry into the schedule history. 0 = Unknown 1 = ConvertedHistory 2 = FlightTimeChange 3 = FlightDesignatorChan…
IJsonResponse
object
Defines the JSON response contract for a not content type response.
3 properties
CommitBookingResponse
object
The response of committing a booking, providing the record locator.
1 property
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
ThreeDSecure
object
Defines three D secure.
24 properties
BundleDiscountAmount
object
The discount amount details for an SSR bundle.
3 properties
InBundleSeatAvailability
object
In-bundle seat availability model.
4 properties
ETicketQueueStatus
integer
Defines the queueing status of e-tickets in the booking. 0 = None 1 = NewIssue 2 = Reissue 3 = Revalidate
Coordinate
object
The defined coordinates of a location.
2 properties
LiftStatus
integer
Lift status enumeration. 0 = Default 1 = CheckedIn 2 = Boarded 3 = NoShow
Category50Responsev2
object
Represents a cat 50 response.
4 properties
OrderCustomer
object
Defines an order customer contact details.
11 properties
BaggageStatus
integer
Baggage Status enumeration. 0 = Default 1 = Checked 2 = Removed 3 = Added 4 = AddedPrinted
TransportationDesignator
object
Model information about the traveling arrival and destination details.
4 properties
DepartureStatus
integer
Departure status. 0 = Default 1 = Cancelled 2 = Boarding 3 = SeeAgent 4 = Delayed 5 = Departed
ExternalBaggageAllowanceInfo
object
Information item used in a external baggage allowance information response.
2 properties
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…
JourneyPriceBreakdown
object
Defines a specifics journey pricing breakdown.
5 properties
PassengerInformation
object
Represents additional passenger information.
6 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
IJsonResponseOfEquipmentBasev2
object
Defines the JSON response contract.
3 properties
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
JourneyPenalty
object
Defines journey penalty.
13 properties
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…
PassengerTravelDocument
object
Model representing a passenger travel document.
14 properties 1 required
Segment
object
Segment model for an already booked flight.
23 properties
IJsonResponseOfGetOverrideFeeQuoteResponse
object
Defines the JSON response contract.
3 properties
ExternalBaggageAllowanceRequest
object
External baggage allowance information request.
1 property 1 required
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
IJsonResponseOfIListOfBookingComment
object
Defines the JSON response contract.
3 properties
Name
object
Defines a common name.
5 properties
OrderAddress
object
Defines an address with GPS coordinates.
8 properties
PassengerBag
object
Model information about the passenger's baggage.
11 properties
PassengerScore
object
Defines a passenger score.
3 properties 1 required
ApisAddressStatus
integer
Defines what type of APIS requirement is the address. 0 = Residence 1 = InCountry 2 = Emergency 3 = Contact
PointOfSale
object
Model related to the point of sale. This is for read-only operations.
4 properties
BookingComment
object
Defines a booking comment.
5 properties
IJsonResponseOfCategory50Responsev2
object
Defines the JSON response contract.
3 properties
Address
object
Defines a common address.
7 properties
BookingVerifiedTravelDocument
object
The model for a dotRez stateful booking verified travel document.
3 properties 2 required
OverrideChannelType
integer
Defines the available channel types to override to. 0 = Direct 1 = Web 2 = Api 3 = DigitalApi 4 = DigitalWeb 5 = Ndc
PassengerSsrAvailability
object
Model containing the details about the availability and price of the Ssr for a specific passenger.
3 properties
IJsonResponseOfBookingPenalty
object
Defines the JSON response contract.
3 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
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
CommitPassengerFeeRequest
object
Defines the request to retrieve a service fee.
6 properties 1 required
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
IJsonResponseOfRecordLocator
object
Defines the JSON response contract.
3 properties
BookingSales
object
Defines the different point of sale information.
3 properties
BookingQueueDeleteByKeyRequest
object
The booking queue delete by queue key request.
3 properties 2 required
BookingInfo
object
Describes general booking details.
16 properties
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
BookingCommentRequest
object
Defines a booking comment.
4 properties
BookingQueueDeleteRequest
object
The booking queue delete request.
4 properties 2 required
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
ExternalBaggageAllowanceCheckedCharge
object
Charge details under each external baggage allowance information item.
2 properties
SsrDurationType
integer
Ssr duration type. 0 = Segment 1 = Journey 2 = Leg
BookingQueueInfo
object
Describes the booking queue info.
14 properties
RecordLocator
object
Defines a unique locator for reference.
7 properties
PaymentDetails
object
Defines the payment details.
9 properties
DeltaMapperOfBookingPointOfSaleEditRequest
object
Map delta changes of a specific type T to another object.
6 properties
ETicketBookingValidationResponse
object
The response for e-ticket booking validation.
1 property
AdditionalSsrAvailability
object
The additional ssr availability model.
9 properties
RecordLocatorCreateRequest
object
The record locator create request model.
5 properties
EquipmentCategory
integer
Represents the category of the equipment used for reservation operations. 0 = None 1 = JetAircraft 2 = PistonAircraft 3 = TurbopropAircraft 4 = Helicopter 5 =…
DepartureEvent
object
Represents the flight operation times for the departure event, which includes an estimated and scheduled time event.
2 properties
IJsonResponseOfIListOfEquipmentBasev2
object
Defines the JSON response contract.
3 properties
IJsonResponseOfIDictionaryOfStringAndIListOfBaggageAllowance
object
Defines the JSON response contract.
3 properties
Ticket
object
Model for a ticket applied to a passenger.
5 properties
FlightType
integer
Flight types enumeration. 0 = None 1 = NonStop 2 = Through 3 = Direct 4 = Connect 5 = All
IJsonResponseOfFareRule
object
Defines the JSON response contract.
3 properties
ConsumerAddress
object
Defines a consumer address.
8 properties
ContentDataType
integer
Defines the content data type enumeration. 0 = Default 1 = Text 2 = RichTextFormat 3 = ImageJpg 4 = ImageGif 5 = ImageBmp 6 = ImagePng 7 = WordDoc 8 = Html 9 =…
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
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
BookingPointOfSaleEditRequest
object
Model related to the booking point of sale edit request. This is to be used for update operations only.
6 properties 2 required
BookingRecordLocators
object
Defines the booking's unique identifiers.
4 properties
OptionalServiceInformation
object
Represents the optional service information model.
2 properties
IJsonResponseOfIListOfBundleAvailability
object
Defines the JSON response contract.
3 properties
MessageStatus
integer
Defines the message status. 0 = General 1 = Warning 2 = Critical
MultipleFeeOverrideRequest
object
Defines the multiple fee override request.
1 property
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
BookingValidationResponse
object
Represents the booking validation response model.
2 properties
Amount
object
Defines an amount base price and total price.
2 properties
FeeRequestBase
object
Defines the request to retrieve a service fee.
2 properties 1 required
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…
BundleAvailability
object
Model containing the bundle ssr availability information.
4 properties
LegInformation
object
Model describing the detailed leg information.
30 properties
ServiceCharge
object
Model that represents the fare service charge information.
9 properties
Journey
object
Data about the journey which represents the collection of segments and their legs on the journey.
7 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
JourneyMove
object
Summarized move data at the journey level.
2 properties
BookingGroupNameRequest
object
The booking group name request model.
1 property
FareOverrideRequest
object
Defines a fare override.
2 properties 1 required
ExternalBaggageAllowanceResponse
object
External baggage allowance information response.
2 properties
DivideRequestv2
object
Defines the booking divide request.
9 properties
BookingInfov2
object
Describes general booking details.
17 properties
IJsonResponseOfETicketBookingValidationResponse
object
Defines the JSON response contract.
3 properties
SeatPreferenceStatus
integer
Defines the seat preference status. 0 = Unknown 1 = Met 2 = NotMet
CommitRequestv2
object
Represents version two of the booking commit request.
7 properties
BundleAvailabilityRequest
object
Represents a bundle availability request.
7 properties
ExternalBaggageAllowanceWeight
object
Weight item for requesting external baggage allowance information.
2 properties
ChallengePreferenceWindowSize
integer
Defines the challenge preference window size. 0 = SizeFullPage 1 = Size250X400 2 = Size390X400 3 = Size500X600 4 = Size600X400
BundleSegmentSsr
object
Model information for a bundle sell service request (SSR) tied to a specific segment.
13 properties
ExternalBaggageAllowanceCheckedDetail
object
External baggage allowance information details for checked baggage.
7 properties
BookingOrderStatus
integer
Booking Order Status Enumeration 0 = None 1 = FinalizedProcess

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tui-group-booking-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 Booking 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.