General
How do I request access to this API?
Access requests are handled through the AOPS Tech support portal. Raise a request at https://tui-air-links.com and the team will provision credentials for your consuming application.
How does authentication work?
The API uses OAuth 2.0 Client Credentials. You exchange a client ID and secret for an access token, then send that token as a Bearer token on every request. See the Technical Information page for token endpoints and example requests.
Are there rate limits?
There are no explicit rate limits enforced on this API today. Consumers should still design clients to retry with backoff and avoid unnecessary polling.
How fresh is the data?
Data is sourced from the TUI crew tracking system and refreshed at five-minute intervals. Responses can be up to five minutes behind the live source system.
Are there any notable constraints?
Most endpoints require an owner parameter identifying the airline the
data applies to (for example BLX, JAF, TFL, TUI, TOM). Date-range endpoints
require both a start and end date.
Parameters
What does the owner parameter mean?
It identifies which TUI airline the requested data belongs to. Valid values are the airline codes BLX, JAF, TFL, TUI, and TOM.
What does responseFile do?
Setting responseFile=true on a request stores the result in a file
instead of returning it inline, and the response includes a link to
retrieve it. This is useful for large result sets. See Large Response
Handling on the Technical Information page for details.
What does region mean on crew complement endpoints?
Region identifies the operational region of the airline for the flight, one of CENTRAL, NORTHERN, or WESTERN. It is required on all crew complement lookups.
What does onlyNonStandard do?
When set to true (the default), crew complement endpoints only return flights where the crew complement differs from the standard configuration. Set it to false to return all flights regardless of whether they deviate from the standard.
Responses
What happens with large responses?
If a response would be too large to return inline, or if you explicitly
request it with responseFile=true, the API stores the result as a file
and returns a link to download it instead of the JSON body.
What format are responses returned in?
All responses are JSON.
Support
Who owns this API?
This API is owned and supported by the AOPS Tech team (airtech-integration).
How do I request a change?
Raise a request through https://tui-air-links.com describing the change
