FAQ — TUI Aviation Flight Schedule API

General

How do I request access to this API?

Visit https://tui-air-links.com and follow the access request process. You will receive OAuth 2.0 client credentials upon approval.

What authentication method is used?

OAuth 2.0 Client Credentials flow. You exchange your client_id and client_secret for a bearer token at the token endpoint, then include it in the Authorization header of every API request.

Are there rate limits?

There are no consumer-facing rate limits enforced by the API at this time. However, responsible usage is expected — avoid unnecessary polling and prefer date-range queries over repeated single-flight lookups.

How fresh is the data?

Data is sourced in real-time from the IDPS Group Replica database. Changes in IDPS are reflected immediately on the next request. The available date range covers current day minus 3 months to current day plus 2 months.

Are there any notable constraints?

• You must use one of the defined parameter combinations (Combos A–I); free-form filtering is not supported.
• All times are in UTC.
• It is not possible to combine different parameter combos in a single request.
• The startDate/endDate range uses a COALESCE of actual, estimated, and rescheduled departure date — not the originally scheduled date.

Parameters

What are the mandatory parameter combos?

Each request must match one of the predefined combos: a single flight lookup (by internal ID, or designator + flight number + date), a date range, or a date combined with a filter (flight owner, aircraft owner, or aircraft registration). See the interactive spec for the full list.

What is the difference between flightDate and plannedDate?

• plannedDate — the date of originally scheduled departure (matches IDPS SF_AB_S).
• flightDate — the operational/rotation date the flight belongs to (matches IDPS AF_DAT).

What does responseFile=true do?

It forces the response to be written to S3 and returns a pre-signed download URL instead of the JSON payload inline. This is also triggered automatically when the response exceeds approximately 5 MB.

What are the optional flag parameters?

Flags like crewMembers, passengers, ACARS, fleet, groundServices, and remarks toggle additional data sections in the response. All default to false.

Responses

What happens if the response is very large?

If the JSON payload exceeds approximately 5 MB (or if responseFile=true), the response body will contain a pre-signed S3 URL valid for 1 hour. Download the file from that URL to get the full JSON.

What format are responses in?

All responses are application/json. There is no XML or CSV option.

What does a 204 response mean?

No flights were found matching your query. The response body will be an empty array [].

Support

Who owns this API?

The API is owned and maintained by the AOPS Tech (airtech-integration) team.

How do I request changes or report issues?

Visit https://tui-air-links.com to raise a support request or feature suggestion.

What is the support email?