Timetable v7

API Docs

Timetable v7

Timetable method will return a list of current departure or arrival flights. The data is the same as in any Airport timetable.

Endpoint:

https://iatacodes.org/api/v7/timetable

Required Params:

api_key - your own api_key received after registration on https://iatacodes.org/

type - type of timetable, can be departure or arrival

iata_code or icao_code - IATA or ICAO code of requested airport, iata_code=SFO, icao_code=KSFO, etc.

Optional Params:

date - requested date in YYYY-MM-DD format, it can be used -1/+2 day from a current date.

hours - requested timetable hours, from 1 to 12

shift - time shift for timetable, from 0 to 23, by default uses the current time in airport time zone

Example Response:

[{
  "status" : "landed",                              // status of a flight
  "airline" : {
    "name" : "Meridiana",                           // airline name
    "icao_code" : "ISS",                            // airline ICAO code
    "iata_code" : "IG"                              // airline IATA code
  }
  "flight" : {
    "number" : "7438",                              // flight number
    "iata_number" : "IG7438",                       // flight number in IATA format
    "icao_number" : "ISS7438"                       // flight number in ICAO format
  },
  "codeshared" : {                                  // original flight details, if codesharing
    "airline" : {
      "name" : "Air Italy",                         // original airline name
      "icao_code" : "AEY",                          // original airline ICAO code
      "iata_code" : "I9"                            // original airline IATA code
    },
    "flight" : {
      "number" : "7438",                            // original flight number
      "iata_number" : "I97438",                     // original IATA flight number
      "icao_number" : "AEY7438"                     // original ICAO flight number
    }
  },
  "arrival" : {
    "actual_runway" : "2017-09-10T07:18:00.000",    // actual runaway touchdown, in airport timezone
    "icao_code" : "LEMH",                           // ICAO code of arrival airport
    "scheduled_time" : "2017-09-10T07:25:00.000",   // scheduled time of arrival
    "actual_time" : "2017-09-10T07:24:00.000",      // actual time of arrival, in airport timezone
    "baggage" : "05",                               // baggage carousel number in arrival airport
    "terminal" : "1",                               // terminal of arrival airport
    "estimated_runway" : "2017-09-10T07:18:00.000", // estimated runaway touchdown time
    "iata_code" : "MAH",                            // IATA code of arrival airport
    "estimated_time" : "2017-09-10T07:24:00.000"    // estimated time of arrival, in airport timezone
  },
  "departure" : {
    "actual_runway" : "2017-09-10T06:06:00.000",    // actual runaway depart time, in airport timezone
    "icao_code" : "LIRF",                           // ICAO code of departure airport
    "scheduled_time" : "2017-09-10T05:55:00.000",   // schedulted time of departure
    "actual_time" : "2017-09-10T05:59:00.000",      // actual time of departure, in airport timezone
    "terminal" : "3",                               // departure airport terminal
    "gate" : "C8",                                  // departure airport gate
    "delay" : 4,                                    // delay from actual departure
    "estimated_runway" : "2017-09-10T06:06:00.000", // estimated runaway departure time
    "iata_code" : "FCO",                            // IATA code of departure airport
    "estimated_time" : "2017-09-10T05:59:00.000"    // estimated time of departure, in airport timezone
  }
}]