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

The inventory API from TUI Group — 7 operation(s) for inventory.

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

This API exposes 11 operations across 7 paths, and defines 39 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.

11 operations 7 paths 39 schemas 1 DELETE4 GET5 PATCH1 POST

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 Inventory 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 11

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

inventory 11
GET
/api/dcs/v2/inventory/legs/{legKey}
Gets the stateless inventory leg.
dcs_v2_inventory_legs_legKey_get 1 param → 200404
PATCH
/api/dcs/v2/inventory/legs/{legKey}
Patches an inventory leg's data, its nests' data, and its classes' data based on information in the request.
dcs_v2_inventory_legs_legKey_patch 1 param body → 200500
GET
/api/dcs/v1/inventory/legs/{legKey}/nests/{legNestKey}
Gets an inventory leg nest by key.
dcs_v1_inventory_legs_legKey_nests_legNestKey_get 2 params → 200404
PATCH
/api/dcs/v1/inventory/legs/{legKey}/nests/{legNestKey}
Patches an inventory leg nest's data based on information in the request.
dcs_v1_inventory_legs_legKey_nests_legNestKey_patch 2 params body → 200500
GET
/api/dcs/v1/inventory/legs/{legKey}/nests/{legNestKey}/classes/{legClassKey}
Gets an inventory leg nest class by key.
dcs_v1_inventory_legs_legKey_nests_legNestKey_classes_legClassKey_get 3 params → 200404
PATCH
/api/dcs/v1/inventory/legs/{legKey}/nests/{legNestKey}/classes/{legClassKey}
Patches an inventory leg nest class's data based on information in the request.
dcs_v1_inventory_legs_legKey_nests_legNestKey_classes_legClassKey_patch 3 params body → 200500
POST
/api/dcs/v1/inventory/legs/ssrs/lids
Returns a list of leg keys and their ssr nest codes and lids. Structured as a POST but behaves as a GET.
dcs_v1_inventory_legs_ssrs_lids_post body → 200207400401404
PATCH
/api/dcs/v1/inventory/legs/ssrs/lids
Patches the ssr lids for multiple specified legs.
dcs_v1_inventory_legs_ssrs_lids_patch body → 200207400401
GET
/api/dcs/v1/inventory/routes/{tripKey}/classes
Gets the classes for a route, stateless.
dcs_v1_inventory_routes_tripKey_classes_get 1 param → 200404
PATCH
/api/dcs/v1/inventory/routes/{tripKey}/classes/{classOfService}
Patches an inventory route class's data based on information in the request.
dcs_v1_inventory_routes_tripKey_classes_classOfService_patch 2 params body → 200500
DELETE
/api/dcs/v1/inventory/routes/{tripKey}/classes/{classOfService}/authorizedUnit
Deletes an inventory route class's authorized unit.
dcs_v1_inventory_routes_tripKey_classes_classOfService_authorizedUnit_delete 2 params → 200

Schemas 39

The contract defines 39 schemas that model the data the API accepts and returns. The most detailed are InventoryLegInformation (12 properties), InventoryLegv2 (11 properties), InventoryLegClass (9 properties), ErrorResponse (8 properties). Each schema is shown below with its type and property counts.

IJsonResponseOfInventoryLegNest
object
Defines the JSON response contract.
3 properties
TransportationIdentifier
object
Represents the transportation identifier model data.
3 properties 2 required
FlyAheadControls
object
The leg fly-ahead control model information.
7 properties
ClassEditDetails
object
Represents the editable details for an inventory leg nest class.
5 properties
TransportationDesignator
object
Model information about the traveling arrival and destination details.
4 properties
IJsonResponseOfInventoryLegv2
object
Defines the JSON response contract.
3 properties
IJsonResponseOfDictionaryOfStringAndListOfInventoryLegSSRLid
object
Defines the JSON response contract.
3 properties
InventoryLegSSRLid
object
Represents an SSR lid update request.
2 properties 2 required
ClassStatus
integer
Indicates whether a leg class may be used or not. 1 = Active 2 = InActive 3 = AvsOpen 4 = AvsOnRequest 5 = AvsClosed
Exception
object
4 properties
LegSsr
object
A model representing a leg ssr summary.
5 properties
SeatsSoldBase
object
Represents the seats sold base model.
4 properties
MessageStatus
integer
Defines the message status. 0 = General 1 = Warning 2 = Critical
FlyAheadOfferStatus
integer
The fly ahead offer status enumeration. 0 = None 1 = Involuntary 2 = Voluntary 3 = DisabledIfFirstLeg
LegMoveControls
object
The leg move control model information.
3 properties
InventoryLegEditv2Request
object
Represents the inventory leg edit v2 request.
5 properties
InventoryLegEditv2NestDetails
object
Represents an individual nest in the v2 leg edit request.
3 properties
InventoryRouteClassEditRequest
object
Represents the edit request for an individual inventory route class.
1 property
InventoryRouteClass
object
Represents classes at the route level.
3 properties
InventoryLegNest
object
Represents the inventory leg nest model.
6 properties
DeltaMapperOfInventoryNestEditRequest
object
Map delta changes of a specific type T to another object.
3 properties
NestType
integer
Nest type enumeration. 0 = Default 1 = Net 2 = Serial 3 = OneBooking
IJsonResponseOfInventoryLegClass
object
Defines the JSON response contract.
3 properties
CodeShareIndicator
integer
Specifies the type of code share agreement. 0 = NonCodeShare 1 = CodeShareCommercialDuplicate 2 = SharedDesignatorOrWetLease 3 = CodeShareHostOperatingCarrier…
InventoryLegSSRLidsPatchRequest
object
Represents the inventory leg and its ssr lids.
2 properties 2 required
IJsonResponseOfIListOfInventoryRouteClass
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
OperatingInformation
object
Represents the operating information model.
4 properties
ErrorResponse
object
Defines a unique error response.
8 properties
LegStatusRequestType
integer
The leg status request enumeration. 0 = Normal 1 = Suspended 2 = BlockAllActivities
LegCrossReference
object
Represents the inventory leg cross reference data.
3 properties
Message
object
Defines a unique informational message.
5 properties
InventoryLegInformation
object
Represents the inventory leg information model.
12 properties
ClassOfServiceType
integer
The class of service type enumeration. 0 = Default 1 = Normal 2 = Discrete 3 = NonNested 4 = NegoAllotment 5 = ProrataAllotment 6 = OperatingBlockspace 7 = Mar…
MarketInformation
object
Model information about the market arrival and destination details.
4 properties 4 required
InventoryLegClass
object
The inventory leg class model.
9 properties
IJsonResponse
object
Defines the JSON response contract for a not content type response.
3 properties
DeltaMapperOfInventoryClassEditRequest
object
Map delta changes of a specific type T to another object.
6 properties
InventoryLegv2
object
Defines the inventory leg v2.
11 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tui-group-inventory-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 Inventory 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.