---
title: "Get scheduled flights"
method: GET
path: "/schedules/{date_start}/{date_end}"
tags: ["miscellaneous"]
---

# Get scheduled flights

`GET /schedules/{date_start}/{date_end}`

## Request

- Base URL: `https://aeroapi.flightaware.com/aeroapi`
- URL: `https://aeroapi.flightaware.com/aeroapi/schedules/{date_start}/{date_end}`
- Auth: API key in header `x-apikey`
- TypeScript: <https://skmtc.dev/flightaware/apis/aeroapi/docs/schedules/:date_start/:date_end/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns scheduled flights that have been published by airlines. These
schedules are available for up to three months in the past as well as
one year into the future.

## Response `200`

OK

- object
  - `links` object, nullable, required: Object containing links to related resources.
    - `next` string, uri-reference, required: A link to the next set of records in a collection.
  - `num_pages` integer, required: Number of pages returned
  - `scheduled` object[], required
    - `ident` string, required: Flight ident
    - `ident_icao` string, nullable, required: Flight ident in ICAO format
    - `ident_iata` string, nullable, required: Flight ident in IATA format
    - `actual_ident` string, nullable, required: If ident is a codeshare flight, this is the primary identifier used by the operator
    - `actual_ident_icao` string, nullable, required: If ident is a codeshare flight, this is the primary identifier used by the operator in ICAO format
    - `actual_ident_iata` string, nullable, required: If ident is a codeshare flight, this is the primary identifier used by the operator in IATA format
    - `aircraft_type` string, required: Aircraft type will generally be ICAO code, but IATA code will be given when the ICAO code is not known
    - `scheduled_in` string, date-time, required: Scheduled time of arrival at gate
    - `scheduled_out` string, date-time, required: Scheduled time of departure from gate
    - `origin` string, required: The origin airport's identifier code
    - `origin_icao` string, nullable, required: The origin airport's ICAO code
    - `origin_iata` string, nullable, required: The origin airport's IATA code
    - `origin_lid` string, nullable, required: The origin airport's LID
    - `destination` string, required: The destination airport's identifier code
    - `destination_icao` string, nullable, required: The destination airport's ICAO code
    - `destination_iata` string, nullable, required: The destination airport's IATA code
    - `destination_lid` string, nullable, required: The destination airport's LID
    - `fa_flight_id` string, nullable, required: Unique FlightAware ID for flight. Will be null for flights scheduled more than a few days in the future.
    - `meal_service` string, required: Meal service offered on the flight
    - `seats_cabin_business` integer, required: Number of seats in the business class cabin
    - `seats_cabin_coach` integer, required: Number of seats in the coach class cabin
    - `seats_cabin_first` integer, required: Number of seats in the first class cabin

## Other responses

- `400`: Incorrect parameter(s). Date_start and date_end must be within time constraints and ISO 8601 format (ex. 1970-01-01T00:00:00Z). Airline and flight_number, if present, must be valid.

---

[API](https://skmtc.dev/flightaware/apis/aeroapi.md) - [All operations](https://skmtc.dev/flightaware/apis/aeroapi/llms.txt) - [OpenAPI document](https://skmtc.dev/flightaware/apis/aeroapi/revisions/3023e7a0c54c?raw)