flights

Retrieves a unique flight by search criteria.

get/schedule/flights

Request

Query parameters

carrierCodestring required

2 to 3-character IATA carrier code (IATA table codes).

flightNumberstring required

1 to 4-digit number of the flight. e.g. 4537

scheduledDepartureDatestring date required

scheduled departure date of the flight, local to the departure airport, format YYYY-MM-DD.

operationalSuffixstring

1-letter operational suffix assigned by the carrier to differentiate flight in case of delay changing the departure date e.g. A

Response

A list of dated flights

Example response

{
  "meta": {
    "count": 1,
    "links": {
      "self": "https://test.api.amadeus.com/v2/schedule/flights?carrierCode=TP&flightNumber=487&scheduledDepartureDate=2023-08-01"
    }
  },
  "data": [
    {
      "type": "DatedFlight",
      "scheduledDepartureDate": "2023-08-01",
      "flightDesignator": {
        "carrierCode": "TP",
        "flightNumber": 487
      },
      "flightPoints": [
        {
          "iataCode": "NCE",
          "departure": {
            "timings": [
              {
                "qualifier": "STD",
                "value": "2023-08-01T18:10+02:00"
              }
            ]
          }
        },
        {
          "iataCode": "LIS",
          "arrival": {
            "timings": [
              {
                "qualifier": "STA",
                "value": "2023-08-01T19:45+01:00"
              }
            ]
          }
        }
      ],
      "segments": [
        {
          "boardPointIataCode": "NCE",
          "offPointIataCode": "LIS",
          "scheduledSegmentDuration": "PT2H35M",
          "partnership": {
            "operatingFlight": {
              "carrierCode": "A3",
              "flightNumber": 1748
            }
          }
        }
      ],
      "legs": [
        {
          "boardPointIataCode": "NCE",
          "offPointIataCode": "LIS",
          "aircraftEquipment": {
            "aircraftType": "E90"
          },
          "scheduledLegDuration": "PT2H35M"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 3 revisions of this API.