Get Timetable

This method retrieves schedule info. It lists all flights in requested route and operation days in a week.

 

Input

Name Description Type Required

scheduleType

W for weekly schedule, M for monthly, D for daily String (W, M, D) Yes

tripType

O for one way, R for round trip String (O, R) Yes

returnDate

Return Date String YYYY-MM-DD Optional

OTA_AirScheduleRQ

Name Description Type Required

AirlineCode

2-letter airline code String (i.e. "TK", "AJ") No

OTA_AirScheduleRQ.OriginDestinationInformation.DepartureDateTime

Name Description Type Required

Date

Departure day and month String YYYY-MM-DD Yes

WindowAfter

How many days should be return after departure date. (If it is P3D, 3 days of schedule will be returned briefly. If it is P0D, only that day in departureDateTime will be returned with all flights.) String (P0D, P3D) Yes

WindowBefore

How many days should be return before departure date. (If it is P3D, 3 days of schedule before DepartureDateTime will be returned briefly. If it is P0D, only that day in departureDateTime will be returned with all flights. String (P0D, P3D) Yes

OTA_AirScheduleRQ.OriginDestinationInformation.OriginLocation

Name Description Type Required

LocationCode

IATA portcode String (IST, LHR) Yes

MultiAirportCityInd

If that city has more than one airport, this should be set as true to get flights departing from all airports in that city. Boolean Yes

OTA_AirScheduleRQ.OriginDestinationInformation.DestinationLocation

Name Description Type Required

LocationCode

IATA portcode String (IST, LHR) Yes

MultiAirportCityInd

If that city has more than one airport, this should be set as true to get flights departing from all airports in that city. Boolean Yes

Output

extendedOTAAirScheduleRS.extraOTAAirScheduleRS.extraOTAAirScheduleRSListType.flightExtraInfo

Name Description Type

totalDuration

Total of flight and transfer durations. "P0Y0M0DT1H5M0S”: it shows duration of flight/journey/transfer in day, hour and minutes. 0y -> year, 0M -> month, 0D -> day, 1H -> one hour, 5M -> 5 minutes String

flightDuration.

Flight duration of a route (including connected flights in total). "P0Y0M0DT1H5M0S”: it shows duration of flight/journey/transfer in day, hour and minutes. 0y -> year, 0M -> month, 0D -> day, 1H -> one hour, 5M -> 5 minutes String

transferDuration

For connected flights, it shows transfer duration or waits for nex flights. "P0Y0M0DT1H5M0S”: it shows duration of flight/journey/transfer in day, hour and minutes. 0y -> year, 0M -> month, 0D -> day, 1H -> one hour, 5M -> 5 minutes String

RPH

"RPH":"0_1" -> first digit (0) shows number of flight option listed. Second digit (1) shows number of connected flight of a flight option. “0_1” means first flight in the list has only one flight (no connected flight) String

extendedOTAAirScheduleRS.OTA_AirScheduleRS.OriginDestinationOptions

Name Description Type

DestinationCode

Requested destination port code String

OriginCode

Requested origin port code String

..OriginDestinationOptions.OriginDestinationOption.FlightSegment

Name Description Type

ScheduleValidStartDate

It shows valid start date in a week of that schedule String

ScheduleValidEndDate

It shows valid end date in a week of that schedule String

StopQuantity

Count of stopover points String

RPH

First digit shows count of flights, second one shows connected flight count. (i.e. 0_2: 0 for first flight; 2 for connected flights) String

DepartureDateTime

Departure date and time String

ArrivalDateTime

Arrival date and time String

FlightNumber

Flight number String

JourneyDuration

Total flight duration including stopover waits String

....FlightSegment.DepartureAirport

Name Description Type

LocationCode

Port Code String

....FlightSegment.ArrivalAirport

Name Description Type

LocationCode

Port Code String

....FlightSegment.MarketingAirline

Name Description Type

Value

It describes marketing airline name String

Code

It shows marketing airline 2-letter code String

....FlightSegment.Equipment

Name Description Type

Value

Equipment (i.e. AIRBUS A320-200) String

AirEquipType

Troya equipment code (i.e. 32P, 2AJ) String

....FlightSegment.OperatingAirline

Name Description Type

FlightNumber

It shows 2-letter airline code with 4 digit flight number. String

Value

It describes operating airline name String

Code

It shows operating airline 2-letter code. String

....FlightSegment.DaysOfOperation.OperationSchedule.OperationTimes.OperationTime

Name Description Type

Text

It shows operation days of a flight in a week. If a flight is not operated a day of a week, it will be shown with dot (.) String

Request

			
{
  "OTA_AirScheduleRQ":{
    "OriginDestinationInformation":{
      "DepartureDateTime":{
        "WindowAfter":"P3D",
        "WindowBefore":"P3D",
        "Date":"2017-10-14"
      },
      "OriginLocation":{
        "LocationCode":"IST",
        "MultiAirportCityInd":true
      },
      "DestinationLocation":{
        "LocationCode":"ESB",
        "MultiAirportCityInd":false
      }
    },
    "AirlineCode":"TK",
    "FlightTypePref":{
      "DirectAndNonStopOnlyInd":false
    }
  },
  "returnDate":"2017-10-20",
  "scheduleType":"W",
  "tripType":"R"
}
		

Response


{
  "status":"SUCCESS",
  "message":{
    "code":"TK-0000",
    "description":"Request Processed Successfully."
  },
  "data":{
    "extendedOTAAirScheduleRS":{
      "extraOTAAirScheduleRS":{
        "extraOTAAirScheduleRSListType":{
          "flightExtraInfo":[
            {
              "totalDuration":"P0Y0M0DT1H5M0S",
              "flightDuration":"P0Y0M0DT1H5M0S",
              "RPH":"0_1",
              "transferDuration":"P0Y0M0DT0H0M0S"
            },
            {
              "totalDuration":"P0Y0M0DT1H5M0S",
              "flightDuration":"P0Y0M0DT1H5M0S",
              "RPH":"1_1",
              "transferDuration":"P0Y0M0DT0H0M0S"
            }
          ]
        }
      },
      "OTA_AirScheduleRS":{
        "OriginDestinationOptions":{
          "DestinationCode":"ESB",
          "OriginCode":"IST",
          "OriginDestinationOption":[
            {
              "FlightSegment":{
                "DepartureAirport":{
                  "CodeContext":"IATA",
                  "LocationCode":"SAW"
                },
                "ScheduleValidStartDate":"2017-10-11",
                "ScheduleValidEndDate":"2017-10-18",
                "ArrivalAirport":{
                  "CodeContext":"IATA",
                  "LocationCode":"ESB"
                },
                "MarketingAirline":{
                  "Value":"TURKISH AIRLINES",
                  "Code":"TK"
                },
                "StopQuantity":"0",
                "DaysOfOperation":{
                  "OperationSchedule":{
                    "OperationTimes":{
                      "OperationTime":{
                        "Text":"12345.."
                      }
                    }
                  }
                },
                "RPH":"0_1",
                "Equipment":{
                  "Value":"UNKNOWN_PLANE",
                  "AirEquipType":"78G"
                },
                "DepartureDateTime":"2017-10-11T10:00:00",
                "ArrivalDateTime":"2017-10-11T11:05:00",
                "FlightNumber":"TK2968",
                "OperatingAirline":{
                  "FlightNumber":"TK2968",
                  "Value":"TURKISH AIRLINES",
                  "Code":"TK"
                },
                "JourneyDuration":"P0DT1H5M0.000S"
              }
            },
            {
              "FlightSegment":{
                "DepartureAirport":{
                  "CodeContext":"IATA",
                  "LocationCode":"SAW"
                },
                "ScheduleValidStartDate":"2017-10-11",
                "ScheduleValidEndDate":"2017-10-18",
                "ArrivalAirport":{
                  "CodeContext":"IATA",
                  "LocationCode":"ESB"
                },
                "MarketingAirline":{
                  "Value":"TURKISH AIRLINES",
                  "Code":"TK"
                },
                "StopQuantity":"0",
                "DaysOfOperation":{
                  "OperationSchedule":{
                    "OperationTimes":{
                      "OperationTime":{
                        "Text":"1234567"
                      }
                    }
                  }
                },
                "RPH":"1_1",
                "Equipment":{
                  "Value":"UNKNOWN_PLANE",
                  "AirEquipType":"78G"
                },
                "DepartureDateTime":"2017-10-11T07:30:00",
                "ArrivalDateTime":"2017-10-11T08:35:00",
                "FlightNumber":"TK2964",
                "OperatingAirline":{
                  "FlightNumber":"TK2964",
                  "Value":"TURKISH AIRLINES",
                  "Code":"TK"
                },
                "JourneyDuration":"P0DT1H5M0.000S"
              }
            }
          ]
        },
        "Version":"0"
      }
    }
  }
}
		

You can find how to test an API in documentation page.