Skip to main content

TUI NewSkies PriceFile Api 1.0

Last updated: 26-Jun-2026
Recent changes: Merge branch 'feature/NSK-75610' into 'master' docs: change API product access to public, update postman collection Closes NSK-75610 See merge request api-program/apigee/flight/newskies-apis/pricefile!33

NewSkies PriceFile API

Overview

This API provides pricefile downloads.

The pricefiles are

  • provided as .csv files
  • in a (base64 encoded) zip-archive and
  • are updated every 15 minutes.

Authentication

This API uses OAuth 2.0 authentication. You must include a valid access token in your requests:

Authorization: Bearer <your_access_token>

Important: Each API key is linked to a specific pricefile mapping, which determines which pricefiles are visible based on role permissions in the NewSkies system. Access must be granted by the NSCC Team.

Note: If you don't have an account yet, register a new external developer account and select NewSkies PriceFile Api as the API Product to gain access to this API.

Base URLs

Base pattern: https://{env}.api.tui/flight/newskies/pricefile

Environment Base URL Comment
Playground https://playground.api.tui/flight/newskies/pricefile Please, use this for testing
Production https://prod.api.tui/flight/newskies/pricefile live production environment

Quick Example

... for downloading a pricefile:

curl -X GET "https://playground.api.tui/flight/newskies/pricefile/download/{filename}" \
     -H "Authorization: Bearer <your_access_token>"

... for checking the pricefile timestamp:

curl -X GET "https://playground.api.tui/flight/newskies/pricefile/download/{filename}/timestamp" \
     -H "Authorization: Bearer <your_access_token>"

Endpoints

Endpoint Description
GET /download/{filename} Download a specific file by name
GET /download/{filename}/timestamp Check timestamp of a specific file
GET /download/delta Download delta (changes only)
GET /download/delta/timestamp Check when delta was last updated

For more information see the technical integration tab.

Important Notes

  1. The pricefile download response body is base64 encoded and must be decoded before extracting the .zip-archive.

  2. Each consumer is mapped to a specific pricefile via their app registration.

About us

TUI is one of the world’s leading tourism groups. The broad portfolio gathered under the Group umbrella consists of strong tour operators, 1,600 travel agencies and leading online portals, five airlines with around 150 aircraft, over 400 hotels, 16 cruise liners and many incoming agencies in all major holiday destinations around the globe.

 

TUI Group logo

Contact

Login to your account