Skip to main content

CheckInHandler Service API 1.0

Last updated: 24-Aug-2026
Recent changes: Merge branch 'feature/NSK-76937' into 'main' move to public Closes NSK-76937 See merge request api-program/apigee/flight/newskies-apis/flight-checkinhandler!22

Description

Overview

The CheckInHandler Service API integrates with Navitaire NewSkies middleware to provide a unified check-in validation and availability service. It is fronted by Apigee X and backed by a .NET Fargate service (ECS) that handles booking lookups, credential validation, and check-in window calculations.

Authentication

The API uses OAuth 2.0 Bearer tokens. Obtain an access token using client credentials flow and include it in the Authorization header.

Authorization: Bearer <access_token>

Base URLs

Environment Base URL
Development https://dev.api.tui/flight/newskies/checkinhandler
Test (SIT) https://test.api.tui/flight/newskies/checkinhandler
Pre-Production https://preprod.api.tui/flight/newskies/checkinhandler
Production https://prod.api.tui/flight/newskies/checkinhandler

Quick Example

curl -X GET "https://test.api.tui/flight/newskies/checkinhandler/checkinavailability?bookingId=ABC123&lastName=Smith" \
  -H "Authorization: Bearer <access_token>"

Endpoints

Method Path Description
GET /recordlocator Resolve a TPRL/PNR to its record locator
GET /checkinavailability Validate credentials and get check-in/login status
GET /checkinoverview Detailed per-segment check-in overview

Response Codes

Code Description
200 Success
400 Bad Request — missing required parameters
404 Not Found — booking not found
401 Unauthorized — invalid or expired token
429 Too Many Requests — rate limit exceeded
500 Internal Server Error

Product Types

The API detects and reports the booking product type:

Type Description Deep Link
Harmonised New TUI check-in product No deep link (handled in-app)
Legacy Carrier-specific legacy check-in Returns deep link URL
Hybrid Mixed segments with both types Returns deep link for legacy segments

Rate Limiting

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