Flights
As of version 4, all supported resources—flights, destinations, airlines, and aircraft types—are integrated into a single OpenAPI specification.
General remarks
Each API response contains a maximum of 20 results. When more results are available, pagination is applied. See Pagination for additional details.
Flight response fields
| Field | Description |
|---|---|
flightDirection | Indicates whether the commercial flight is a departure (d) or arrival (a). |
flightName | The flight name of the commercial flight as shown on the passenger's ticket. Example: KL672. |
flightNumber | The numeric part of the flight name. Example: 5005. |
prefixIATA | The two-character IATA prefix of the airline that operates the commercial flight. Example: KL. |
prefixICAO | The three-character ICAO prefix of the airline that operates the commercial flight. Example: KLM. |
scheduleDate | The date on which the scheduled commercial flight will operate. Example: 2015-06-17. |
scheduleTime | The time the commercial flight is scheduled to depart or arrive. Example: 15:25:00. |
serviceType | Category of the commercial flight: J = Passenger Line, C = Passenger Charter, F = Freight Line, and H = Freight Charter. |
mainFlight | For a codeshare (one flight with several flight numbers from different airlines), the main flight shows the flight number of the airline that operates the flight. |
codeshares | All flight numbers related to the main flight. |
route | The complete route of the commercial flight. Most flights travel directly between two airports, but some have more than one stopover. Example: GCK-AMS-LGW (Jakarta – Amsterdam – London Gatwick). |
publicFlightState | The status of a public flight. See Flight Statuses. Example: Boarding. |
terminal | The section of the Schiphol terminal from which the commercial flight departs or at which it arrives. This is Departure 1, 2, 3, or 4, or Arrival 1, 2, 3, or 4. |
gate | The gate from which the scheduled flight departs and passengers board. Gates are in piers B, C, D, E, F, G, M, and H. Example: C12. |
baggageClaim | The luggage belt number in the reclaim hall (reclaim 1, 2, 3, or 4) where arriving passengers can collect their luggage. |
checkinAllocations | The check-in desks allocated to the flight (or flights, in the case of a codeshare). |
| Check-in class | The flight classes allocated to a specific flight. Example: E (Economy). |
transferPositions | The transfer desks allocated to the flight. |
aircraftType.iatamain | The IATA main category code of the aircraft that operates the main flight. Example: 739 (Boeing 737-900). |
aircraftType.iatasub | The IATA subcategory code of the aircraft that operates the main flight. Example: 73J (Boeing 737-900W). |
aircraftRegistration | The unique alphanumeric string identifying the aircraft that operates the main scheduled flight. Example: PHTFA. |
estimatedLandingTime | The expected time the arriving flight will land at Amsterdam Airport Schiphol. |
actualLandingTime | The time the aircraft landed on the runway. |
publicEstimatedOffBlockTime | The publicly displayed expected departure time of a departing flight. It is shown on flight displays in the terminal, on the website and Schiphol app, and on information terminals in the lounges. |
actualOffBlockTime | The actual time a flight departs from Amsterdam Airport Schiphol. |
expectedTimeGateOpen | The time the gate is expected to be opened by the flight handler. |
expectedTimeBoarding | The expected time passenger boarding for a flight will start. |
expectedTimeGateClosing | The time the flight handler is expected to close the gate. |
expectedTimeOnBelt | The time the first luggage from a flight is expected to be available on the reclaim belt. |
airlineCode | The numeric NVLS code of the airline. |
routesEu | S (Schengen), E (Europe), or N (non-Europe). |
visa | Whether the destination requires a visa (true) or not (false). |
lastUpdated | The time of the last update to the flight in the flight information system. |
id | Unique identifier of the flight. |
schemaVersion | Schema version of the API. |
Aircraft types
The API offers information about all aircraft types operated by airlines on flights to and from Amsterdam Airport Schiphol.
| Field | Description |
|---|---|
| Long name or public name | Example: Boeing 737-900 Winglets. |
| IATA subcategory code | International Air Transport Association code consisting of three digits. Example: 73J. |
| Short name | Example: Boeing 737-900/W. |
| IATA main category code | International Air Transport Association code consisting of three digits. Example: 739. |
Aircraft types can be searched by long name, short name, IATA main category code, or IATA subcategory code.
Airlines
The API offers information about all passenger airlines operating to and from Amsterdam Airport Schiphol.
| Field | Description |
|---|---|
| Public name | The public name of the airline. Example: KLM. |
| IATA code/prefix | International Air Transport Association code consisting of two letters or digits. Example: KL. |
| ICAO code/prefix | International Civil Aviation Organization code consisting of three letters. Example: KLM. |
Airlines can be searched by IATA code/prefix, ICAO code/prefix, or public name.
Destinations
The API offers information about destinations airlines serve to and from Amsterdam Airport Schiphol.
| Field | Description |
|---|---|
| IATA airport code | Three-letter code for the destination airport. Examples: VCE (Venice) and FRA (Frankfurt am Main). A destination with multiple airports (such as Paris, London, or New York) can have multiple IATA codes. For example, Paris has CDG (Paris Charles de Gaulle) and ORY (Paris Orly). |
| Public name in English | Example: Venice. |
| Public name in Dutch | Example: Venetië. |
| City name (in English) | Example: Venice. |
| Country name (in English) | The name of the country where the destination is located. |
Destinations can be searched by IATA airport code, public name (in English or Dutch), or country name.