fromDateTimestring(local-date-time)required
From date of search period. Format: yyyy-MM-dd’T’HH:mm:ss
toDateTimestring(local-date-time)required
To date of search period (inclusive). Format: yyyy-MM-dd’T’HH:mm:ss
Retrieve flight IDs based on a datetime range
Returns a list of flight IDs for flights scheduled within the specified datetime range (filters on scheduleDateTime). Max date range is three days.
get
https://api.schiphol.nl/public/public-flights/v4/flights/ids
Query Parameters
Headers
Acceptstringrequired
Only ‘application/json’ is allowed
Example:application/json
ResourceVersionstringrequired
Resource version of the API
Match pattern:v4
Example:v4
Response
application/json
Response
application/json
List of flight IDs
array[string]
get/flights/ids
Authentication
Query Parameters
Headers
application/json
Retrieves flights for a specific date
Retrieves flights for a specific date. If scheduleDate is provided as query parameter, it will retrieve flights for that date. If not provided it is defaulted to today. If there are more hits then allowed on one page response headers will contain the URLs where other pages of the results can be reached.For example:
Link: <protocol://server_address:port/public-flights/resource> ; rel=“first”,
<protocol://server_address:port/public-flights/resource?page=10> rel=“last”,
<protocol://server_address:port/public-flights/resource?page=3> rel=“next”,
<protocol://server_address:port/public-flights/resource?page=1> rel=“prev”
get
https://api.schiphol.nl/public/public-flights/v4/flights
Query Parameters
scheduleDatestring(date)
Scheduled date to get flights for. Format: yyyy-MM-dd. Defaults to today if not provided
scheduledatestring(date)
See: scheduleDate. Prefer scheduleDate. If both scheduleDate and scheduledate are used scheduleDate takes precedence
scheduleTimestring(hour-minute)
Scheduled time to get flights from. Format: HH:mm
flightNamestring
Flight number as printed on the ticket
>= 5 characters<= 8 characters
flightnamestring
See: flightName. Prefer flightName. If both flightName and flightname are used flightName takes precedence
>= 5 characters<= 8 characters
flightDirectionstring
Direction of the flight
Allowed values:AD
flightdirectionstring
See: flightDirection. Prefer using flightDirection. If both flightDirection and flightdirection are used flightDirection takes precedence
Allowed values:AD
airlinestring
Prefix in flight number as printed on the ticket. For exmaple: KL. This can either be a 2-character (IATA) airline prefix or 3-character (ICAO) airline prefix. Only one airline (or airlineCode) can be queried at the same time.
>= 2 characters<= 3 characters
airlineCodeinteger(int32)
routestring
IATA or ICAO code of airport in route; multiple values, comma separated
>= 1 characters
includedelaysboolean
Include flights of earlier an scheduleDate when these have enough delay to shift to the date that is queried upon.
Default:false
includeDelaysboolean
See: includedelays. Prefer includedelays. If both includeDelays and includeDelays are used, includedelays take precedence.
Default:false
pageinteger(int32)
Default:0
>= 0<= 499
sortstring
Specifies which field to use for sorting. Allowed values are flightName, scheduleDate, scheduleTime, flightDirection, mainFlight, airlineCode, id, and all fields from the searchDateTimeField parameter. Use plus or minus sign to indicate ascending or descending order. Multiple fields are allowed and should be separated by a comma. For example “-scheduleDate, +scheduleTime”.
Match pattern:^((\+|-| )?(flightName|scheduleDate|scheduleTime|flightDirection|mainFlight|airlineCode|id|estimatedLandingTime|actualLandingTime|publicEstimatedOffBlockTime|actualOffBlockTime|expectedTimeBoarding|expectedTimeGateClosing|expectedTimeGateOpen|expectedTimeOnBelt|scheduleDateTime|lastUpdatedAt)(,|$))+$
Default:+scheduleTime
fromDateTimestring(local-date-time)
From date of search period. Format: yyyy-MM-dd’T’HH:mm:ss
toDateTimestring(local-date-time)
To date of search period (inclusive). Format: yyyy-MM-dd’T’HH:mm:ss
searchDateTimeFieldstring
Query by a specific DateTime field. Allowed fields are estimatedLandingTime, actualLandingTime, publicEstimatedOffBlockTime, actualOffBlockTime, expectedTimeBoarding, expectedTimeGateClosing, expectedTimeGateOpen, expectedTimeOnBelt, scheduleDateTime, lastUpdatedAt
Allowed values:estimatedLandingTimeactualLandingTimepublicEstimatedOffBlockTimeactualOffBlockTimeexpectedTimeBoardingexpectedTimeGateClosingexpectedTimeGateOpenexpectedTimeOnBeltscheduleDateTimelastUpdatedAt
fromScheduleDatestring(date)
Query by ScheduleDate range.
toScheduleDatestring(date)
Query by ScheduleDate range
isOperationalFlightboolean
Query based on operational/non-operational flights.true for operational and false for non-operational flights
Headers
Acceptstringrequired
Only ‘application/json’ is allowed
Example:application/json
ResourceVersionstringrequired
Resource version of the API
Match pattern:v4
Example:v4
Response
application/json
Response
application/json
OK
FlightList
flightsarray[object]
Show Child Parameters
get/flights
Authentication
Query Parameters
Headers
application/json
Retrieves list of airlines
Retrieves a list of airlines. If there are more hits then allowed on one page response headers will contain the URLs where other pages of the results can be reached.For example:
Link: <protocol://server_address:port/public-flights/resource> ; rel=“first”,
<protocol://server_address:port/public-flights/resource?page=10> rel=“last”,
<protocol://server_address:port/public-flights/resource?page=3> rel=“next”,
<protocol://server_address:port/public-flights/resource?page=1> rel=“prev”
get
https://api.schiphol.nl/public/public-flights/v4/airlines
Query Parameters
pageinteger(int32)
Default:0
>= 0<= 499
sortstring
Specifies which field to use for sorting. Allowed fields are publicName, iata, icao and nvls. Use plus or minus sign to indicate ascending or descending order.
Match pattern:^((\+|-| )?(publicName|iata|icao|nvls)(,|$))+$
Default:+iata
Headers
Acceptstringrequired
Only ‘application/json’ is allowed
Example:application/json
ResourceVersionstringrequired
Resource version of the API
Match pattern:v4
Example:v4
Response
application/json
Response
application/json
OK
AirlineList
airlinesarray[object]
Show Child Parameters
get/airlines
Authentication
Query Parameters
Headers
application/json
Retrieves airline based on code (IATA or ICAO)
Retrieve airline based on IATA code or ICAO code.
get
https://api.schiphol.nl/public/public-flights/v4/airlines/{airline}
Path Parameters
airlinestringrequired
IATA / ICAO code
>= 2 characters<= 3 characters
Headers
Acceptstringrequired
Only ‘application/json’ is allowed
Example:application/json
ResourceVersionstringrequired
Resource version of the API
Match pattern:v4
Example:v4
Response
application/json
Response
application/json
OK
Airline
iatastring
icaostring
nvlsinteger(int64)
publicNamestring
get/airlines/{airline}
Authentication
Path Parameters
Headers
application/json
Retrieves list of aircrafttypes
Retrieves list of aircrafttypes. If there are more hits then allowed on one page response headers will contain the URLs where other pages of the results can be reached.For example:
Link: <protocol://server_address:port/public-flights/resource> ; rel=“first”,
<protocol://server_address:port/public-flights/resource?page=10> rel=“last”,
<protocol://server_address:port/public-flights/resource?page=3> rel=“next”,
<protocol://server_address:port/public-flights/resource?page=1> rel=“prev”
get
https://api.schiphol.nl/public/public-flights/v4/aircrafttypes
Query Parameters
iataMainstring
IATA main code
>= 3 characters<= 3 characters
iataSubstring
IATA sub code
>= 3 characters<= 3 characters
pageinteger(int32)
Default:0
>= 0<= 499
sortstring
Specifies which field to use for sorting. Allowed fields are iataMain, iataSub, longDescription and shortDescription. Use plus or minus sign to indicate ascending or descending order.
Match pattern:^((\+|-| )?(iataMain|iataSub|longDescription|shortDescription)(,|$))+$
Default:+iataMain
Headers
Acceptstringrequired
Only ‘application/json’ is allowed
Example:application/json
ResourceVersionstringrequired
Resource version of the API
Match pattern:v4
Example:v4
Response
application/json
Response
application/json
OK
AircraftTypeList
aircraftTypesarray[object]
Show Child Parameters
get/aircrafttypes
Authentication
Query Parameters
Headers
application/json