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 |
| aircraft | object | information related to the aircraft |
| 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... |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/flight-offers-price-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"
},
"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"
}
}
},
"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"
}
}
},
"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"
}
}
}
]
}
}
}
}Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/flight-offers-price-flight-segment"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.