Last updated:
17-Apr-2026
Recent changes:
Merge branch 'feature/NSK-72563-fix-prod-catalog-publish' into 'main'
NSK-72563: Fix prod catalog publish — api-product-prod now triggerable on...
Closes NSK-72563
See merge request api-program/apigee/flight/newskies-apis/flight-availability-search-api!30
API Details
Endpoints
The Flight Availability Search API exposes the following REST API endpoints:
| Environment | Base URL |
|---|---|
| Development | https://dev.api.tui/flight/newskies/availability/v2 |
| Test | https://test.api.tui/flight/newskies/availability/v2 |
| Pre-Production | https://pre-prod.api.tui/flight/newskies/availability/v2 |
| Production | https://prod.api.tui/flight/newskies/availability/v2 |
API Methods
GET /search
Search for available flights based on various criteria.
Request Example:
GET /search?outboundStartDate=2024-06-01&outboundEndDate=2024-06-30&departureStationCodes=BRU&arrivalStationCodes=ALC&tripType=0&PassengerCount=2 HTTP/1.1
Host: test.api.tui
Authorization: Bearer <your_access_token>
Accept: application/jsonResponse Example (200 OK):
{
"groups": [
{
"name": "BRU-ALC",
"flights": [
{
"departureDateTime": "2024-06-15T10:30:00Z",
"arrivalDateTime": "2024-06-15T13:15:00Z",
"carrierCode": "TB",
"flightNumber": "1234",
"departureStationCode": "BRU",
"arrivalStationCode": "ALC",
"availability": 9,
"flightDuration": 165,
"fares": [
{
"fareBasisCode": "YOWRT",
"currencyCode": "EUR",
"priceGrossAdt": 150.00,
"priceNetAdt": 130.00,
"taxes": 15.00,
"fees": 5.00
}
]
}
]
}
]
}HTTP Headers
Request Headers
| Header Name | Required | Type | Description | Example |
|---|---|---|---|---|
Authorization |
Yes | String | OAuth 2.0 Bearer token | Bearer <token> |
Accept |
No | String | Response content type | application/json |
Response Headers
| Header Name | Description |
|---|---|
Content-Type |
Response content type (always application/json) |
Date |
Response timestamp |
Query Parameters Reference
Required Parameters
| Parameter | Type | Format | Description |
|---|---|---|---|
outboundStartDate |
Date | yyyy-MM-dd | Start date for outbound flight search |
outboundEndDate |
Date | yyyy-MM-dd | End date for outbound flight search |
tripType |
Integer | 0 or 1 | 0 = One-way, 1 = Round-trip |
Conditional Parameters
| Parameter | Type | Format | Required When | Description |
|---|---|---|---|---|
inboundStartDate |
Date | yyyy-MM-dd | tripType = 1 | Start date for return flight search |
inboundEndDate |
Date | yyyy-MM-dd | tripType = 1 | End date for return flight search |
Optional Filter Parameters
| Parameter | Type | Format | Description | Example |
|---|---|---|---|---|
departureStationCodes |
String | Comma-separated | Departure airport codes | BRU,LHR,MAN |
arrivalStationCodes |
String | Comma-separated | Arrival airport codes | ACE,LPA,PMI |
departureCountries |
String | Comma-separated | Departure country codes | GB,DE,BE |
arrivalCountries |
String | Comma-separated | Arrival country codes | ES,FR,IT |
carrierCodes |
String | Comma-separated | Airline carrier codes | TB,OR,X3 |
PassengerCount |
Integer | 1-9 | Number of passengers (default: 1) | 2 |
GroupBy |
Integer | 0 or 1 | 0 = OriginDestination, 1 = Date | 0 |
LimitGroups |
Integer | Positive integer | Maximum groups to return | 10 |
LimitFlights |
Integer | Positive integer | Maximum flights per group | 5 |
Response Codes
| Code | Status | Description | Response Body |
|---|---|---|---|
| 200 | OK | Successful search | SearchResponse object |
| 400 | Bad Request | Invalid parameters or validation error | Error object |
| 401 | Unauthorized | Missing or invalid access token | Error object |
| 500 | Internal Server Error | Server-side error | Error object |
Data Models
SearchResponse
{
"groups": [FlightGroup]
}FlightGroup
{
"name": "string",
"flights": [Flight]
}Flight
{
"departureDateTime": "2024-06-15T10:30:00Z",
"arrivalDateTime": "2024-06-15T13:15:00Z",
"carrierCode": "TB",
"flightNumber": "1234",
"departureStationCode": "BRU",
"arrivalStationCode": "ALC",
"departureCountryCode": "BE",
"arrivalCountryCode": "ES",
"availability": 9,
"flightDuration": 165,
"journeyKey": "TB~1234~20240615~BRU~ALC",
"encryptedJourneyKey": "encrypted_key",
"operatingCarrierCode": "TB",
"stopOverFlights": [StopOverFlight],
"fares": [Fare]
}Fare
{
"fareBasisCode": "YOWRT",
"ruleNumber": "123",
"productClass": "Y",
"classOfService": "Y",
"fareKey": "fare_key_123",
"encryptedFareKey": "encrypted_fare_key",
"currencyCode": "EUR",
"priceGrossAdt": 150.00,
"priceGrossChd": 120.00,
"priceGrossInf": 25.00,
"priceNetAdt": 130.00,
"priceNetChd": 100.00,
"taxes": 15.00,
"fees": 5.00,
"surcharges": 0.00
}StopOverFlight
{
"stationCode": "MAD",
"carrierCode": "TB",
"operatingCarrierCode": "TB",
"flightNumber": "5678",
"sta": "2024-06-15T11:30:00Z",
"std": "2024-06-15T12:15:00Z"
}Error
{
"ErrorMessage": "Validation error message",
"StackTrace": null
}
