Skip to Content

9. GetFlightlineWeekdays

Last modified by Giorgi Mdivnishvili on 2025/10/03 18:27
Contents

 

Method Description

This method returns a structured list of available flight line routes between specific cities and countries, including their unique identifiers, ISO codes, and the days of the week when outbound (forward) and inbound (backward) flights operate. It is primarily used to determine flight availability schedules for different destinations, enabling applications to display, filter, or validate travel options based on country, city, and operating weekdays.

EndpointURL - [GET]

Information

https://integration.kazunion.com/api/Catalogue/GetFlightlineWeekdays

Request Parameters

none

Request Body

none

Response example success with data

{
   "flightLineInfo": [
        {
           "cityID": 2,
           "cityUID": "1be9f87d-d05d-4375-bcff-0a2b725728a8",
           "countryID": 213,
           "countryUID": "2502c1c6-ea24-4cfb-bf5c-e8574a5f7a4b",
           "countryISO2": "TR",
           "countryISO3": "TUR",
           "forwardDays": [
               "Friday",
               "Monday",
               "Saturday",
               "Sunday",
               "Thursday",
               "Tuesday",
               "Wednesday"
            ],
           "backwardDays": [
               "Friday",
               "Monday",
               "Saturday",
               "Sunday",
               "Thursday",
               "Tuesday",
               "Wednesday"
            ]
        },
        {
           "cityID": 7,
           "cityUID": "00127d62-4396-4a6d-8524-1e798d8ec7f8",
           "countryID": 3,
           "countryUID": "872c4641-6553-42ae-b78a-02b6a1e41f8c",
           "countryISO2": "AZ",
           "countryISO3": "AZE",
           "forwardDays": [
               "Monday",
               "Saturday",
               "Sunday",
               "Thursday",
               "Tuesday"
            ],
           "backwardDays": [
               "Friday",
               "Monday",
               "Saturday",
               "Sunday",
               "Wednesday"
            ]
        },
        {
           "cityID": 7,
           "cityUID": "00127d62-4396-4a6d-8524-1e798d8ec7f8",
           "countryID": 54,
           "countryUID": "a7c67ece-0c59-4097-bc6e-3d9ab91f206b",
           "countryISO2": "GE",
           "countryISO3": "GEO",
           "forwardDays": [
               "Friday",
               "Sunday",
               "Tuesday"
            ],
           "backwardDays": [
               "Friday",
               "Sunday",
               "Tuesday"
            ]
        },
        {
           "cityID": 7,
           "cityUID": "00127d62-4396-4a6d-8524-1e798d8ec7f8",
           "countryID": 59,
           "countryUID": "ebbed186-6711-46c9-9618-4258dc4bf314",
           "countryISO2": "QA",
           "countryISO3": "QAT",
           "forwardDays": [
               "Friday"
            ],
           "backwardDays": [
               "Friday"
            ]
        },
        {
           "cityID": 7,
           "cityUID": "00127d62-4396-4a6d-8524-1e798d8ec7f8",
           "countryID": 62,
           "countryUID": "fead4059-3958-42d9-ab98-4446de89c0f1",
           "countryISO2": "AE",
           "countryISO3": "ARE",
           "forwardDays": [
               "Friday",
               "Monday",
               "Saturday",
               "Sunday",
               "Thursday",
               "Tuesday",
               "Wednesday"
            ],
           "backwardDays": [
               "Friday",
               "Monday",
               "Saturday",
               "Sunday",
               "Thursday",
               "Tuesday",
               "Wednesday"
            ]
        },
        {
           "cityID": 7,
           "cityUID": "00127d62-4396-4a6d-8524-1e798d8ec7f8",
           "countryID": 213,
           "countryUID": "2502c1c6-ea24-4cfb-bf5c-e8574a5f7a4b",
           "countryISO2": "TR",
           "countryISO3": "TUR",
           "forwardDays": [
               "Friday",
               "Monday",
               "Saturday",
               "Sunday",
               "Thursday",
               "Tuesday",
               "Wednesday"
            ],
           "backwardDays": [
               "Friday",
               "Monday",
               "Saturday",
               "Sunday",
               "Thursday",
               "Tuesday",
               "Wednesday"
            ]
        }
    ],
   "error": false,
   "activityId": "00-320ba6dd988f2c14404005946457623a-217813b4b368ef5f-01"
}

Response example success with data

{
 "error": true,
 "errorCode": "string",
 "errorDescription": "string",
 "userErrorDescription": "string",
 "activityId": "string",
 "flightLineInfo": [
    {
     "cityID": 0,
     "cityUID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
     "countryID": 0,
     "countryUID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
     "countryISO2": "string",
     "countryISO3": "string",
     "forwardDays": [
       "Sunday"
      ],
     "backwardDays": [
       "Sunday"
      ]
    }
  ]
}

Schema

Success

schemas/GetFlightlineWeekdaysResponseGetFlightlineWeekdaysResponse{

errorboolean
errorCodestring
nullable: true
errorDescriptionstring
nullable: true
userErrorDescriptionstring
nullable: true
activityIdstring
nullable: true
flightLineInfo[
nullable: trueFlightlineWeekdays{
cityIDinteger($int32)
cityUIDstring($uuid)
countryIDinteger($int32)
countryUIDstring($uuid)
countryISO2string
nullable: true
countryISO3string
nullable: true
forwardDays[
nullable: trueDayOfWeekDayOfWeekstringEnum:
[ Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday ]]
backwardDays[
nullable: trueDayOfWeekDayOfWeekstringEnum:
[ Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday ]]

}]

}

Root Object

FieldTypeDescription
flightLineInfoArray of ObjectsList of flight line records (city–country combinations) with schedule details.
errorBooleanIndicates if the request was successful (false) or failed (true).
activityIdString (UUID)Unique identifier of the request/response, useful for debugging and tracking.

flightLineInfo Object Fields

FieldTypeDescription
cityIDIntegerInternal numeric identifier of the city.
cityUIDString (UUID)Globally unique identifier of the city.
countryIDIntegerInternal numeric identifier of the country.
countryUIDString (UUID)Globally unique identifier of the country.
countryISO2String (2 chars)ISO 3166-1 Alpha-2 code of the country (e.g., "TR" = Turkey).
countryISO3String (3 chars)ISO 3166-1 Alpha-3 code of the country (e.g., "TUR" = Turkey).
forwardDaysArray of StringList of weekdays when forward (outbound) flights are available.
backwardDaysArray of StringList of weekdays when backward (return) flights are available.