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/journeys API

The booking/journeys API from TUI Group — 18 operation(s) for booking/journeys.

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

This API exposes 24 operations across 18 paths, and defines 85 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.

24 operations 18 paths 85 schemas 7 DELETE8 GET1 PATCH4 POST4 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/journeys 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 24

Across 18 paths, the API surfaces 24 operations — 7 DELETE, 8 GET, 1 PATCH, 4 POST, 4 PUT. Each is listed below with its method, path, parameters, and response codes.

booking/journeys 24
GET
/api/nsk/v1/booking/journeys
Gets the collection of journeys on the booking in state
nsk_v1_booking_journeys_get → 200404
DELETE
/api/nsk/v1/booking/journeys
Cancels all the journeys on the current booking in state
nsk_v1_booking_journeys_delete → 200400403409
GET
/api/nsk/v1/booking/journeys/{journeyKey}
Gets a single journey by the key
nsk_v1_booking_journeys_journeyKey_get 1 param → 200404
DELETE
/api/nsk/v1/booking/journeys/{journeyKey}
Cancels the specific journey from the booking in state
nsk_v1_booking_journeys_journeyKey_delete 1 param body → 200400403409
DELETE
/api/nsk/v1/booking/journeys/{journeyKey}/bundles
Removes the add-on service bundles of the requested passengers in the given…
nsk_v1_booking_journeys_journeyKey_bundles_delete 1 param body → 404200409
POST
/api/nsk/v2/booking/journeys/{journeyKey}/bundles
Sells a service bundle for one or more passengers on a journey
nsk_v2_booking_journeys_journeyKey_bundles_post 1 param body → 201409
DELETE
/api/nsk/v1/booking/journeys/{journeyKey}/fees/penalty
Waives the penalty fee of the specified journey
nsk_v1_booking_journeys_journeyKey_fees_penalty_delete 1 param → 200409
GET
/api/nsk/v1/booking/journeys/{journeyKey}/passengers/{passengerKey}/address/requirements
Gets the passenger or associated infant's destination address requirements for…
nsk_v1_booking_journeys_journeyKey_passengers_passengerKey_address_requirements_get 2 params → 200404
GET
/api/nsk/v1/booking/journeys/{journeyKey}/passengers/{passengerKey}/baggage
Gets all baggage for a passenger on a specific journey
nsk_v1_booking_journeys_journeyKey_passengers_passengerKey_baggage_get 2 params → 200404
POST
/api/nsk/v1/booking/journeys/{journeyKey}/passengers/{passengerKey}/baggage
Adds baggage to the booking
nsk_v1_booking_journeys_journeyKey_passengers_passengerKey_baggage_post 2 params body → 201409
GET
/api/nsk/v1/booking/journeys/{journeyKey}/passengers/{passengerKey}/baggage/{baggageKey}
Gets a single bag from a passenger on a journey
nsk_v1_booking_journeys_journeyKey_passengers_passengerKey_baggage_baggageKey_get 3 params → 200404
PUT
/api/nsk/v1/booking/journeys/{journeyKey}/passengers/{passengerKey}/baggage/{baggageKey}deprecated
Checks-in the baggage for a passenger on the booking in state
nsk_v1_booking_journeys_journeyKey_passengers_passengerKey_baggage_baggageKey_put 3 params body → 200500409
DELETE
/api/nsk/v1/booking/journeys/{journeyKey}/passengers/{passengerKey}/baggage/{baggageKey}
Removes baggage from the booking
nsk_v1_booking_journeys_journeyKey_passengers_passengerKey_baggage_baggageKey_delete 3 params → 200409
PUT
/api/nsk/v2/booking/journeys/{journeyKey}/passengers/{passengerKey}/baggage/{baggageKey}
Updates the baggage for a passenger on the booking in state
nsk_v2_booking_journeys_journeyKey_passengers_passengerKey_baggage_baggageKey_put 3 params body → 200400
PUT
/api/nsk/v1/booking/journeys/{journeyKey}/passengers/{passengerKey}/baggage/{baggageKey}/checkin
Checks in the baggage for a passenger on the booking in state
nsk_v1_booking_journeys_journeyKey_passengers_passengerKey_baggage_baggageKey_checkin_put 3 params body → 200400
PUT
/api/nsk/v1/booking/journeys/{journeyKey}/passengers/{passengerKey}/baggage/group
Moves passenger to a different baggage group
nsk_v1_booking_journeys_journeyKey_passengers_passengerKey_baggage_group_put 2 params body → 200500409
POST
/api/nsk/v1/booking/journeys/{journeyKey}/passengers/{passengerKey}/baggage/manual
Adds manually tagged baggage to the booking
nsk_v1_booking_journeys_journeyKey_passengers_passengerKey_baggage_manual_post 2 params body → 201409
DELETE
/api/nsk/v1/booking/journeys/{journeyKey}/passengers/{passengerKey}/fees/amount
Waives fees for a specific journey and passenger, based upon the given fee type.
nsk_v1_booking_journeys_journeyKey_passengers_passengerKey_fees_amount_delete 2 params body → 201409
POST
/api/nsk/v1/booking/journeys/{journeyKey}/passengers/{passengerKey}/infant
Creates an infant on a passenger in the specified journey
nsk_v1_booking_journeys_journeyKey_passengers_passengerKey_infant_post 2 params body → 201400409
DELETE
/api/nsk/v1/booking/journeys/{journeyKey}/passengers/{passengerKey}/infant
Deletes an infant from a passenger in the specified journey
nsk_v1_booking_journeys_journeyKey_passengers_passengerKey_infant_delete 2 params → 200409
PATCH
/api/nsk/v1/booking/journeys/{journeyKey}/segments/{segmentKey}/status
Modifies the status of the specified segment in the journey
nsk_v1_booking_journeys_journeyKey_segments_segmentKey_status_patch 3 params → 200409
GET
/api/nsk/v1/booking/journeys/{journeyKey}/travelDocument/requirements
Gets the travel document requirements for a specific journey for the booking…
nsk_v1_booking_journeys_journeyKey_travelDocument_requirements_get 1 param → 200404
GET
/api/nsk/v1/booking/journeys/passengers/{passengerKey}/address/requirements
Gets the passenger or associated infant's destination address requirements for…
nsk_v1_booking_journeys_passengers_passengerKey_address_requirements_get 1 param → 200404
GET
/api/nsk/v1/booking/journeys/travelDocument/requirements
Gets the travel document requirements for all journeys for the booking in-state
nsk_v1_booking_journeys_travelDocument_requirements_get → 200404

Schemas 85

The contract defines 85 schemas that model the data the API accepts and returns. The most detailed are LegInformation (30 properties), PassengerSegment (29 properties), Segment (23 properties), Fare (22 properties). Each schema is shown below with its type and property counts.

SsrDurationType
integer
Ssr duration type. 0 = Segment 1 = Journey 2 = Leg
PassengerBagRequest
object
A model for a request to update the passenger bags.
6 properties
Exception
object
4 properties
CancelJourneyRequest
object
Defines the options available when canceling a journey.
4 properties
Segment
object
Segment model for an already booked flight.
23 properties
SeatPreferenceStatus
integer
Defines the seat preference status. 0 = Unknown 1 = Met 2 = NotMet
IJsonResponseOfPassengerBag
object
Defines the JSON response contract.
3 properties
PassengerBag
object
Model information about the passenger's baggage.
11 properties
FeePricingMode
integer
The fee pricing mode enumeration. 0 = MonetaryOnly 1 = PointsOnly
TravelClassSeatPreference
integer
Represents a travel class seating preference. 0 = None 1 = Business 2 = Economy 3 = FirstClass
IJsonResponseOfJourney
object
Defines the JSON response contract.
3 properties
FareApplicationType
integer
This enumeration defines the fare application type of a fare. 0 = Route 1 = Sector 2 = Governing
PassengerScore
object
Defines a passenger score.
3 properties 1 required
BundleSellRequest
object
The bundle sell request.
3 properties 1 required
SsrByKeyRequest
object
SSR detail for a specific passenger number.
3 properties 1 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…
IJsonResponseOfBoolean
object
Defines the JSON response contract.
3 properties
Ticket
object
Model for a ticket applied to a passenger.
5 properties
OverbookIndicatorTypes
integer
Specifies the type of code share agreement. 0 = NormalSell 1 = Oversold 2 = ClassOrCabinOversold
LegStatus
integer
Leg status enumeration. 0 = Normal 1 = Closed 2 = Canceled 3 = Suspended 5 = ClosedPending 6 = BlockAllActivities 7 = Mishap
CollectType
integer
Used to identify the collect type of a service charge. 0 = SellerChargeable 1 = ExternalChargeable 2 = SellerNonChargeable 3 = ExternalNonChargeable 4 = Extern…
GssStayType
integer
The type of stay type. 0 = None 1 = Vacation 2 = Business 3 = Duty
FareDesignator
object
Model describing the fare designator information.
1 property
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
PassengerFare
object
Model that represents the passenger fare details.
5 properties 1 required
FareStatus
integer
This enumeration defines the fare status of a passenger fare. 0 = Default 1 = SameDayStandBy 2 = FareOverrideConfirming 3 = FareOverrideConfirmed 4 = Published…
SeatPreferences
object
Represents the seating preferences base model.
3 properties
LegInformation
object
Model describing the detailed leg information.
30 properties
Fare
object
Model describing a fare.
22 properties
DepartureEvent
object
Represents the flight operation times for the departure event, which includes an estimated and scheduled time event.
2 properties
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
LiftStatus
integer
Lift status enumeration. 0 = Default 1 = CheckedIn 2 = Boarded 3 = NoShow
NestType
integer
Nest type enumeration. 0 = Default 1 = Net 2 = Serial 3 = OneBooking
MessageStatus
integer
Defines the message status. 0 = General 1 = Warning 2 = Critical
PassengerManualBagRequest
object
A model for a request to update the passenger bags.
7 properties 3 required
LegClass
object
The leg class model information.
11 properties 1 required
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…
CodeShareIndicator
integer
Specifies the type of code share agreement. 0 = NonCodeShare 1 = CodeShareCommercialDuplicate 2 = SharedDesignatorOrWetLease 3 = CodeShareHostOperatingCarrier…
ModifySegmentStatus
integer
The status in which the segment can be changed to. 0 = UnknownStatus 1 = NoActionTaken 2 = UnableToConfirmSegment 3 = HeldConfirmed 4 = HeldCancelled 5 = Confi…
IJsonResponseOfTravelDocumentRequirements
object
Defines the JSON response contract.
3 properties
SegmentStatus
integer
The segment status. 0 = UnknownStatus 1 = UnableToConfirmSegment 2 = UnableToSellSegment 3 = HeldPending 4 = WaitListConfirmed 5 = HeldUnconfirmed 6 = HeldConf…
SimpleSeatPreference
integer
Represents a simple seating preference. 0 = None 1 = Window 2 = Aisle 3 = Other
TravelDocumentRequirements
object
Defines the type of sale values.
2 properties
DepartureStatus
integer
Departure status. 0 = Default 1 = Cancelled 2 = Boarding 3 = SeeAgent 4 = Delayed 5 = Departed
TicketIndicatorCode
integer
This enumeration defines the ticket requirements 0 = Unknown 1 = TicketRequired 2 = AutomatedTicketLiftRequired 3 = ManualTicketLiftRequired 4 = AutomatedTicke…
ManualBag
object
A base class for baggage models.
6 properties 4 required
PassengerSeat
object
Model for a passenger seat for a segment.
11 properties
BaggageStatus
integer
Baggage Status enumeration. 0 = Default 1 = Checked 2 = Removed 3 = Added 4 = AddedPrinted
Name
object
Defines a common name.
5 properties
PointOfSale
object
Model related to the point of sale. This is for read-only operations.
4 properties
TicketStatusCode
integer
This enumeration defines the ticket availability status. 0 = Unknown 1 = TicketAvailableForUse 2 = TicketUnavailableForUse 3 = TicketReissueRequiredForPassenge…
PassengerTravelDocument
object
Model representing a passenger travel document.
14 properties 1 required
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 =…
OperationsInformation
object
Model describing the operations information.
15 properties
PassengerBagUpdateRequest
object
A model for a request to update the passenger bags.
3 properties
SegmentTypes
integer
Indicates the type of a segment. 0 = Normal 1 = CodeShareOperating 2 = CodeShareMarketing 3 = InterlineOutbound 4 = InterlineInbound 5 = Passive
TransportationDesignator
object
Model information about the traveling arrival and destination details.
4 properties
SeatInfo
object
The model for the seat information such as deck, seat properties, etc.
3 properties
PassengerBagCheckInRequest
object
A model for a request to check-in the passenger bags.
3 properties
LegSsr
object
A model representing a leg ssr summary.
5 properties
PassengerSegment
object
Model data for the passenger on the booking for the specific segment.
29 properties
SsrByKeysRequestv2
object
Request to add a leg, segment, or journey Ssr.
4 properties 1 required
SeatPreference
object
Represents a single seat preference.
3 properties 2 required
PassengerInfantCreateRequest
object
Model representing infant data that can be set.
7 properties
Leg
object
Model data describing the leg which is a single travel leg from point a to b.
8 properties
GateInformation
object
Represents the gate information for the trip status model. Consists of actual gate information and estimated/scheduled gate information.
2 properties
ServiceCharge
object
Model that represents the fare service charge information.
9 properties
JourneyMove
object
Summarized move data at the journey level.
2 properties
Message
object
Defines a unique informational message.
5 properties
IJsonResponseOfIListOfPassengerBag
object
Defines the JSON response contract.
3 properties
IJsonResponseOfIListOfJourney
object
Defines the JSON response contract.
3 properties
PassengerSsr
object
The model for a passengers Ssr details.
13 properties
InboundOutbound
integer
This enumeration specifies direction of flight application. 0 = None 1 = Inbound 2 = Outbound 3 = Both 4 = RoundFrom 5 = RoundTo
Gender
integer
Defines the different binary gender types. 0 = XX 1 = Male 2 = Female
MarketInformation
object
Model information about the market arrival and destination details.
4 properties 4 required
PassengerBoardingPassDetail
object
Defines information used to populate the printed boarding pass and 2D bar codes.
7 properties
PassengerBagGroupRequest
object
Request to move passengers to a different baggage group.
1 property
TransportationIdentifier
object
Represents the transportation identifier model data.
3 properties 2 required
LegNest
object
A model representing a leg nest.
6 properties
ArrivalStatus
integer
Arrival status. 0 = Default 1 = Cancelled 2 = Arrived 3 = SeeAgent 4 = Delayed
PassengerSegmentBag
object
Model information about the baggage a passenger has on a segment.
6 properties 3 required
WeightType
integer
Weight Type enumeration. 0 = Default 1 = Pounds 2 = Kilograms
IJsonResponse
object
Defines the JSON response contract for a not content type response.
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tui-group-booking-journeys-api-openapi.yml Raw ↑

Other APIs TUI Group publishes across the network.

TUI Group Account API
TUI Group Airline Profile 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
TUI Group Booking API
Where this information came from

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