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

The Ota API from TUI Group — 12 operation(s) for ota.

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

This API exposes 13 operations across 12 paths, and defines 36 schemas. It is described by OpenAPI 3.2.0, at version 0.9.

Requests are made against 2 base URLs: https://prod.api.tui, https://playground.api.tui.

13 operations 12 paths 36 schemas 12 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.9
Base URL
https://prod.api.tui/flight/newskies/rest
Authentication
OAuth 2.0
Contact
Resource Areas
1

Authentication & Security 1

TUI Group Ota API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (oAuth2ClientCredentials) using the clientCredentials flow.

Paths & Operations 13

Across 12 paths, the API surfaces 13 operations — 12 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Ota 13
GET
/ota/getflights
Returns all available flight routes and their corresponding flight keys.
getflights → 200
GET
/ota/flightavailability
Returns flight availability, pricing and seat information for a given route and travel dates.
flightavailablity 8 params → 200404
GET
/ota/includedluggage
Luggage that's included
includdedluggage 3 params → 200
GET
/ota/luggage
Returns the available checked luggage (hold baggage) options and pricing for a specific flight.
luggage 3 params → 200
GET
/ota/pricecalculation
Calculates the total price for a flight including selected ancillaries. When the "book" parameter is set to 1, it also creates a reservation.
pricecalculcation 26 params → 200
GET
/ota/pay
Submits a virtual card payment for an existing reservation. Supports two modes: standard payment (cardnumber, cvc, expirydate) or encrypted card payment (cardnumber).
pay 6 params → 200
POST
/ota/pay
Submits a credit card payment for an existing reservation. Supports two modes: standard payment (cardnumber, cvc, expirydate) or encrypted card payment (cardnumber).
post_pay 6 params → 200
GET
/ota/bookinfo
Retrieves information about a specific reservation.
bookinfo 1 param → 200404
GET
/ota/servicebundle
Retrieves information about servicebundles.
servicebundle 2 params → 200404
GET
/ota/handluggage
Returns the possible handluggage options for a specific flight. Codes: PBAG = Personal bag (max 2kg, 40x30x20 cm), HBAG = Hand baggage / cabin trolley (max 10kg, 55x40x20 cm).
handluggage 3 params → 200
GET
/ota/sports
Returns the possible sports equipment options for a specific flight. Codes: SURFBOARD = Surfboard, WINTERSPORTSEQUIPMENT = Winter sports equipment (skis, snowboard, etc.), PARAGLIDERPARACHUTE = Parag…
sports 3 params → 200
GET
/ota/assistance
Returns the possible assistance options for a specific flight. Codes: YPTA = Young passenger travelling alone, WCHS = Wheelchair - cannot walk long distances or climb stairs but can walk to seat, WCH…
assistance 3 params → 200
GET
/ota/pets
Returns the possible pet transport options for a specific flight. Codes: PETC = Dog/cat up to 8kg (including bag) in the cabin, AVIH = Dog/cat in the heated cargo hold.
pets 3 params → 200

Schemas 36

The contract defines 36 schemas that model the data the API accepts and returns. The most detailed are priceCalculationBook (25 properties), flightLeg (20 properties), flightLegCheckout (18 properties), flightLegPriceCheck (14 properties). Each schema is shown below with its type and property counts.

directionIncludedLuggage
array
flightkey
string
A flight key. Concatenation of ORIGIN + DESTINATION + DATE + TIME
sportsResponse
object
1 property
flightLegPriceCheck
object
14 properties
directionLuggage
array
priceCalculationBook
object
25 properties
flight
object
11 properties
dimensions
object
4 properties
flightLegCheckout
object
18 properties
getflightsResponse
object
1 property
luggageResponse
object
2 properties
flightavailabilityResponse
object
3 properties
ancillariesInformation
object
2 properties
includedLuggageInformation
object
5 properties
priceCalculationPrice
object
9 properties
direction
array
servicebundleInfo
array
bookinfoResponse
object
14 properties
servicebundleResponse
object
1 property
assistanceResponse
object
1 property
handluggageResponse
object
1 property
luggageInformation
object
2 properties
handluggageInformation
object
4 properties
priceObjectPriceCheck
object
2 properties
detailsObject
object
4 properties
detailsArray
array
directionAncillaries
array
locale
string
Locale used for adjust the request. Defaults to nlBE.
flightLeg
object
20 properties
payResponse
object
2 properties
directionHandluggage
array
includedLuggageResponse
object
2 properties
mealCode
string
'Meal codes descriptions': - 'None' X - 'No meal' S - 'Standard meal' V - 'Service Plus' CC - 'Comfort Service'
petsResponse
object
1 property
locationCode
string
priceNumberPriceCheck
number

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

tui-group-ota-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 Ota 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.