idstringrequired
Unique numeric id of flight
Match pattern:^[0-9]+$
Retrieves a Flight based on flight-id
get
https://api.schiphol.nl/public/public-flights/v4/flights/{id}
Path 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
OK
Flight
lastUpdatedAtstring(date-time)
actualLandingTimestring(date-time)
yyyy-MM-dd’T’HH:mm:ss.SSSZ
actualOffBlockTimestring(date-time)
yyyy-MM-dd’T’HH:mm:ss.SSSZ
aircraftRegistrationstring
aircraftTypeobject
Show Child Parameters
baggageClaimobject
Show Child Parameters
checkinAllocationsobject
Show Child Parameters
codesharesobject
Show Child Parameters
estimatedLandingTimestring(date-time)
yyyy-MM-dd’T’HH:mm:ss.SSSZ
expectedTimeBoardingstring(date-time)
yyyy-MM-dd’T’HH:mm:ss.SSSZ
expectedTimeGateClosingstring(date-time)
yyyy-MM-dd’T’HH:mm:ss.SSSZ
expectedTimeGateOpenstring(date-time)
yyyy-MM-dd’T’HH:mm:ss.SSSZ
expectedTimeOnBeltstring(date-time)
yyyy-MM-dd’T’HH:mm:ss.SSSZ
expectedSecurityFilterstring
expected security filter
flightDirectionstring
Allowed values:AD
flightNamestring
flightNumberinteger(int64)
gatestring
pierstring
idstring
isOperationalFlightboolean
mainFlightstring
prefixIATAstring
prefixICAOstring
airlineCodeinteger(int64)
publicEstimatedOffBlockTimestring(date-time)
yyyy-MM-dd’T’HH:mm:ss.SSSZ
publicFlightStateobject
Show Child Parameters
routeobject
Show Child Parameters
scheduleDateTimestring(date-time)
yyyy-MM-dd’T’HH:mm:ss.SSSZ
scheduleDatestring(date)
yyyy-MM-dd
scheduleTimestring
hh:mm:ss
serviceTypestring
The service type category of the commercial flight. For example: J = Passenger Line, C=Passenger Charter, F = Freight Line and H = Freight Charter etc.
terminalinteger(int64)
transferPositionsobject
Show Child Parameters
schemaVersionstring
get/flights/{id}
Authentication
Path Parameters
Headers
application/json
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
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
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