Amadeus · Schema

FlightSegment

defining a flight segment; including both operating and marketing details when applicable

TravelTravel TechnologyReservationsFlightsHotelsAirlinesHospitalityTours and ActivitiesCars and TransfersDestination ContentItinerary ManagementTrip PlanningArtificial IntelligenceMarket Insights

Properties

Name Type Description
departure object departure or arrival information
arrival object departure or arrival information
carrierCode string providing the airline / carrier code
number string the flight number as assigned by the carrier
suffix string the flight number suffix as assigned by the carrier
aircraft object information related to the aircraft
class string reservation booking designator (RBD) of the carrier
cabin string booking cabin / class of service of the carrier
operating object information about the operating flight
duration string stop duration in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) PnYnMnDTnHnMnS format, e.g. PT2H10M
stops array information regarding the different stops composing the flight segment. E.g. technical stop, change of gauge...
View JSON Schema on GitHub

JSON Schema

flight-choice-prediction-flight-segment-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/flight-choice-prediction-flight-segment-schema.json",
  "title": "FlightSegment",
  "description": "defining a flight segment; including both operating and marketing details when applicable",
  "type": "object",
  "properties": {
    "departure": {
      "title": "FlightEndPoint",
      "description": "departure or arrival information",
      "allOf": [
        {
          "type": "object",
          "description": "departure or arrival information",
          "properties": {
            "iataCode": {
              "description": "[IATA airline codes](http://www.iata.org/publications/Pages/code-search.aspx)",
              "type": "string",
              "example": "JFK"
            },
            "terminal": {
              "description": "terminal name / number",
              "type": "string",
              "example": "T2"
            }
          }
        },
        {
          "type": "object",
          "properties": {
            "at": {
              "description": "local date and time in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) YYYY-MM-ddThh:mm:ss format, e.g. 2017-02-10T20:40:00",
              "type": "string",
              "format": "date-time",
              "example": "2017-10-23T20:00:00"
            }
          }
        }
      ]
    },
    "arrival": {
      "title": "FlightEndPoint",
      "description": "departure or arrival information",
      "allOf": [
        {
          "type": "object",
          "description": "departure or arrival information",
          "properties": {
            "iataCode": {
              "description": "[IATA airline codes](http://www.iata.org/publications/Pages/code-search.aspx)",
              "type": "string",
              "example": "JFK"
            },
            "terminal": {
              "description": "terminal name / number",
              "type": "string",
              "example": "T2"
            }
          }
        },
        {
          "type": "object",
          "properties": {
            "at": {
              "description": "local date and time in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) YYYY-MM-ddThh:mm:ss format, e.g. 2017-02-10T20:40:00",
              "type": "string",
              "format": "date-time",
              "example": "2017-10-23T20:00:00"
            }
          }
        }
      ]
    },
    "carrierCode": {
      "type": "string",
      "description": "providing the airline / carrier code",
      "minLength": 1,
      "maxLength": 2,
      "example": "DL"
    },
    "number": {
      "type": "string",
      "description": "the flight number as assigned by the carrier",
      "minLength": 1,
      "maxLength": 4,
      "example": "212"
    },
    "suffix": {
      "type": "string",
      "description": "the flight number suffix as assigned by the carrier",
      "minLength": 1,
      "maxLength": 4,
      "example": "string-value"
    },
    "aircraft": {
      "description": "information related to the aircraft",
      "properties": {
        "code": {
          "type": "string",
          "description": "IATA aircraft code (http://www.flugzeuginfo.net/table_accodes_iata_en.php)\n",
          "pattern": "[a-zA-Z0-9]{3}",
          "example": "318"
        },
        "configurationVersion": {
          "type": "string",
          "description": "aircraft Configuration Version code. Physical configuration, also called ACV code (aircraft type + fitted configuration)\n",
          "pattern": "[A-Z0-9]{3}",
          "example": "2C1"
        }
      }
    },
    "class": {
      "type": "string",
      "description": "reservation booking designator (RBD) of the carrier",
      "minLength": 1,
      "maxLength": 2,
      "example": "string-value"
    },
    "cabin": {
      "type": "string",
      "description": "booking cabin / class of service of the carrier",
      "example": "string-value"
    },
    "operating": {
      "type": "object",
      "description": "information about the operating flight",
      "properties": {
        "carrierCode": {
          "type": "string",
          "description": "providing the airline / carrier code",
          "minLength": 1,
          "maxLength": 2,
          "example": "DL"
        },
        "number": {
          "type": "string",
          "description": "the flight number as assigned by the carrier",
          "minLength": 1,
          "maxLength": 4,
          "example": "212"
        },
        "suffix": {
          "type": "string",
          "description": "the flight number suffix as assigned by the carrier",
          "minLength": 1,
          "maxLength": 4,
          "example": "string-value"
        }
      }
    },
    "duration": {
      "type": "string",
      "description": "stop duration in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) PnYnMnDTnHnMnS format, e.g. PT2H10M",
      "example": "PT2H10M"
    },
    "stops": {
      "type": "array",
      "description": "information regarding the different stops composing the flight segment. E.g. technical stop, change of gauge...",
      "items": {
        "title": "FlightStop",
        "description": "details of stops for direct or change of gauge flights",
        "allOf": [
          {
            "description": "details of stops for direct or change of gauge flights",
            "type": "object",
            "properties": {
              "iataCode": {
                "description": "[IATA airline codes](http://www.iata.org/publications/Pages/code-search.aspx)",
                "type": "string",
                "example": "JFK"
              },
              "duration": {
                "type": "string",
                "description": "stop duration in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) PnYnMnDTnHnMnS format, e.g. PT2H10M",
                "example": "PT2H10M"
              }
            }
          },
          {
            "type": "object",
            "properties": {
              "arrivalAt": {
                "description": "arrival at the stop in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) YYYY-MM-ddThh:mm:ss format, e.g. 2017-02-10T20:40:00",
                "type": "string",
                "format": "date-time",
                "example": "2017-10-23T20:00:00"
              },
              "departureAt": {
                "description": "departure from the stop in [ISO8601](https://en.wikipedia.org/wiki/ISO_8601) YYYY-MM-ddThh:mm:ss format, e.g. 2017-02-10T20:40:00",
                "type": "string",
                "format": "date-time",
                "example": "2017-10-23T20:00:00"
              }
            }
          }
        ]
      }
    }
  }
}