Search
K
Schiphol Public Flight API

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

OK

FlightList

flightsarray[object]
Show Child Parameters
get/flights
 
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

OK

AirlineList

airlinesarray[object]
Show Child Parameters
get/airlines
 
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

OK

Airline

iatastring
icaostring
nvlsinteger(int64)
publicNamestring
get/airlines/{airline}
 
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

OK

AircraftTypeList

aircraftTypesarray[object]
Show Child Parameters
get/aircrafttypes
 
application/json

Retrieves list of destinations

Retrieves list of destinations

If there are more pages of the result, header will contain custom String field - Link, which will contain 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/destinations

Query Parameters

pageinteger(int32)

Default:0

>= 0<= 499

sortstring

Specifies which field to use for sorting. Allowed fields are publicName.dutch, publicName.english, iata, country and city… Use plus or minus sign to indicate ascending or descending order.

Match pattern:^((\+|-| )?(publicName\.dutch|publicName\.english|iata|country|city)(,|$))+$

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

OK

DestinationList

destinationsarray[object]
Show Child Parameters
get/destinations
 
application/json