API Details

Endpoints Reference

GET /recordlocator

Resolves a Third Party Record Locator (TPRL) or PNR to the NewSkies record locator.

Query Parameters:

Example Request:

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

Example Response (200):

{
  "recordLocator": "ABC123"
}

Error Responses:

GET /checkinavailability

Validates booking credentials and returns check-in/login availability status with product type information. Only shows future (not departed) segments.

Query Parameters:

Example Request:

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

Example Response (Harmonised Product):

{
  "recordLocator": "ABC123",
  "loginStatus": {
    "success": true,
    "errorMessage": null
  },
  "checkInStatus": {
    "productType": "Harmonised",
    "deepLinkUrl": null,
    "segments": [
      {
        "departureStation": "DUS",
        "arrivalStation": "PMI",
        "departureDateUtc": "2026-08-15T10:30:00Z",
        "checkInOpensMinutesBeforeDeparture": 1440,
        "checkInClosesMinutesBeforeDeparture": 120,
        "checkInAvailable": true,
        "errorMessage": null
      }
    ]
  }
}

Example Response (Legacy Product with Deep Link):

{
  "recordLocator": "ABC123",
  "loginStatus": {
    "success": true,
    "errorMessage": null
  },
  "checkInStatus": {
    "productType": "Legacy",
    "deepLinkUrl": "https://www.tui.nl/en/checkin/DeepLink?rl=ABC123&ln=Smith",
    "segments": [
      {
        "departureStation": "AMS",
        "arrivalStation": "AGP",
        "departureDateUtc": "2026-08-20T08:00:00Z",
        "checkInOpensMinutesBeforeDeparture": 1440,
        "checkInClosesMinutesBeforeDeparture": 180,
        "checkInAvailable": true,
        "errorMessage": null
      }
    ]
  }
}

Example Response (Wrong Credentials):

{
  "recordLocator": null,
  "loginStatus": {
    "success": false,
    "errorMessage": "WrongCredentials"
  },
  "checkInStatus": {
    "productType": null,
    "deepLinkUrl": null,
    "segments": null
  }
}

GET /checkinoverview

Returns a detailed check-in overview for a booking with per-segment availability, document status, and pending check-in information. Only shows future (not departed) segments.

Query Parameters:

Example Request:

curl -X GET "https://test.api.tui/flight/newskies/checkinhandler/checkinoverview?bookingid=ABC123&lastname=Smith" \
  -H "Authorization: Bearer <token>"

Example Response (200):

{
  "recordLocator": "ABC123",
  "market": "de",
  "loginStatus": {
    "success": true,
    "errorMessage": null
  },
  "checkInStatus": {
    "productType": "Harmonised",
    "deepLinkUrl": null,
    "segments": [
      {
        "departureStation": "DUS",
        "arrivalStation": "PMI",
        "departureDate": "2026-08-15T10:30:00Z",
        "checkInAvailable": true,
        "checkInOpensMinutesBeforeDeparture": 1440,
        "checkInClosesMinutesBeforeDeparture": 120,
        "hasDocumentsAvailable": true,
        "hasPendingCheckIn": false,
        "routeAllowsDocuments": true
      }
    ]
  }
}

Error Responses:

Data Models

RecordLocatorResponse

CheckInValidation

LoginStatus

CheckInStatus

CheckInSegment

CheckInOverview

CheckInOverviewSegment