TUI Group

TUI CheckInHandler Service API

REST service in the New Skies flight family described on the portal as the complete API specification for CheckInHandler Service endpoints. The published page documents the playground and production base URLs and the x-correlation-id and versioned Accept headers, but the operation table on the public page is still template placeholder content.

GitHub OpenAPI

Documentation

📖
Documentation
https://developer.tui/api-catalog/checkinhandler-service-api/api-description
📖
Documentation
https://developer.tui/api-catalog/checkinhandler-service-api/api-details
📖
Documentation
https://developer.tui/api-catalog/checkinhandler-service-api/technical-integration

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/tui-group/refs/heads/main/openapi/tui-group-tui-checkinhandler-service-api-openapi.yml

Other Resources

🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/tui-group/refs/heads/main/overlays/tui-group-tui-checkinhandler-service-api-overlay.yaml

OpenAPI Specification

tui-group-tui-checkinhandler-service-api-openapi.yml Raw ↑ 
openapi: 3.0.3
info:
  title: CheckInHandler Service API
  description: Complete API specification for CheckInHandler Service endpoints
  version: 1.0
  contact:
    name: Flight Production - Passenger Logistics
    url: https://tui.atlassian.net/wiki/spaces/NST/overview?homepageId=172195842
    email: skywalker@tui.de
x-header: |
  Complete API specification for CheckInHandler Service endpoints
x-summary: |
  Complete API specification for CheckInHandler Service endpoints
servers:
  - url: https://dev.api.tui/flight/newskies/checkinhandler
  - url: https://test.api.tui/flight/newskies/checkinhandler
  - url: https://preprod.api.tui/flight/newskies/checkinhandler
  - url: https://prod.api.tui/flight/newskies/checkinhandler

paths:
  /recordlocator:
    get:
      tags:
        - CheckInHandler
      summary: Returns the Record Locator value for a booking
      description: Returns the Record Locator value from the Third Party Record Locator and the passenger last name.
      parameters:
        - name: bookingId
          in: query
          required: true
          schema:
            type: string
        - name: lastName
          in: query
          required: true
          schema:
            type: string
      responses:
        '200':
          description: RecordLocator
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecordLocatorResponse'
        '404':
          description: BookingNotFound
        '500':
          description: InternalServerError
  /checkinavailability:
    get:
      tags:
        - CheckInHandler
      summary: Returns the CheckIn/Login status for a booking
      description: Returns the CheckIn/Login status from the TPRL/PNR and the passenger last name.
      parameters:
        - name: bookingId
          in: query
          required: true
          schema:
            type: string
        - name: lastName
          in: query
          required: true
          schema:
            type: string
      responses:
        '200':
          description: CheckIn/Login status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CheckInValidation'
        '500':
          description: InternalServerError
components:
  schemas:
    CheckInStatus:
      type: object
      properties:
        productType:
          type: string
          nullable: true
        deepLinkUrl:
          type: string
          nullable: true
        checkInAvailable:
          type: boolean
        errorMessage:
          type: string
          nullable: true
      additionalProperties: false
    CheckInValidation:
      type: object
      properties:
        recordLocator:
          type: string
          nullable: true
        loginStatus:
          $ref: '#/components/schemas/LoginStatus'
        checkInStatus:
          $ref: '#/components/schemas/CheckInStatus'
      additionalProperties: false
    LoginStatus:
      type: object
      properties:
        success:
          type: boolean
        errorMessage:
          type: string
          nullable: true
      additionalProperties: false
    RecordLocatorResponse:
      type: object
      properties:
        recordLocator:
          type: string
          nullable: true
      additionalProperties: false
tags:
  - name: CheckInHandler