Get Started

This guide walks you through making your first request to the Flight Price Cache API.

Prerequisites

1. An API key — Register on the TUI Developer Portal for the API product flight-newskies-pricecache-api.
2. AgentName mapping — Contact yoda@tui.de with your app name to get your API key mapped to a NewSkies agent.

Step 1 — Obtain an Access Token

The API uses OAuth 2.0 client credentials flow. Use your consumer key and secret to obtain a token:

curl -X POST "https://test.api.tui/oauth2/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id={your_client_id}&client_secret={your_client_secret}"

Response:

{
  "access_token": "eyJhbGciOiJSUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 3600
}

Step 2 — Make Your First Request

Use the /cheapflights endpoint to search for the cheapest flights on a route:

curl -X GET "https://test.api.tui/flight/newskies/availability/cheapflights?Origin=BRU&Destination=ALC&Start=2025-06-01&End=2025-06-30&Duration=7&TripType=0&GroupBy=4&LimitGroups=10&LimitOffers=1" \
  -H "Authorization: Bearer {your_access_token}"

Parameters Explained

Step 3 — Explore Other Endpoints

• /connections — Discover available routes before searching
• /search — Full availability search with detailed fare information
• /calendardata — Calendar-style availability view
• /dayleveloffers — Aggregated day-level pricing
• /productclassproperties — Product class configuration

Step 4 — Move to Production

1. Test your integration thoroughly in the Test environment
2. Contact yoda@tui.de to confirm production readiness
3. Switch your base URL to https://prod.api.tui/flight/newskies/availability

Need Help?

• API access & AgentName mapping: yoda@tui.de