Amadeus · Schema

locations

Description of a particular point or place in physical space

TravelTravel TechnologyReservationsFlightsHotelsAirlinesHospitalityTours and ActivitiesCars and TransfersDestination ContentItinerary ManagementTrip PlanningArtificial IntelligenceMarket Insights

Properties

Name Type Description
type string type of API result "location"
subtype string Location sub-type (e.g. airport, port, rail-station, restaurant, atm...)
name string Label associated to the location (e.g. Eiffel Tower, Madison Square)
iataCode string IATA location code
geoCode object Geographic coordinates describing the position of any location on the surface of Earth
address object
timeZone object
metrics object
View JSON Schema on GitHub

JSON Schema

airport-routes-locations-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/airport-routes-locations-schema.json",
  "title": "locations",
  "description": "Description of a particular point or place in physical space",
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "type of API result \"location\"",
      "example": "string-value"
    },
    "subtype": {
      "type": "string",
      "description": "Location sub-type (e.g. airport, port, rail-station, restaurant, atm...)",
      "example": "string-value"
    },
    "name": {
      "type": "string",
      "description": "Label associated to the location (e.g. Eiffel Tower, Madison Square)",
      "example": "\"Eiffel Tower\""
    },
    "iataCode": {
      "type": "string",
      "description": "IATA location code",
      "example": "\"PAR\""
    },
    "geoCode": {
      "type": "object",
      "description": "Geographic coordinates describing the position of any location on the surface of Earth",
      "properties": {
        "latitude": {
          "type": "number",
          "description": "Latitude of the position expressed in decimal degrees (WSG 84), e.g. 6.244203. A positive value denotes northern hemisphere or the equator, and a negative value denotes southern hemisphere. The number of digits to represent the precision of the coordinate.",
          "example": "48.85837",
          "minimum": -3.402823669209384e+38,
          "multipleOf": 3.402823669209384e+38
        },
        "longitude": {
          "type": "number",
          "description": "Longitude of the position expressed in decimal degrees (WSG 84), e.g. -75.581211. A positive value denotes east longitude or the prime meridian, and a negative value denotes west longitude. The number of digits to represent the precision of the coordinate.",
          "example": "2.294481",
          "minimum": -3.402823669209384e+38,
          "multipleOf": 3.402823669209384e+38
        }
      }
    },
    "address": {
      "type": "object",
      "properties": {
        "countryName": {
          "type": "string",
          "description": "Name of the country of the location",
          "example": "France"
        },
        "countryCode": {
          "type": "string",
          "description": "Code of the country of the location in ISO standard",
          "example": "FR"
        },
        "stateCode": {
          "type": "string",
          "description": "Code of the state of the location (if any)",
          "example": "FR-13"
        },
        "regionCode": {
          "type": "string",
          "description": "Code of the region of the location in ISO standard",
          "example": "EUROP"
        }
      }
    },
    "timeZone": {
      "type": "object",
      "properties": {
        "offSet": {
          "type": "string",
          "description": "'Total offset from UTC including the Daylight Saving Time (DST) following ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601) standard'",
          "example": "+01:00"
        },
        "referenceLocalDateTime": {
          "type": "string",
          "description": "Date and time used as reference to determine the time zone name, code, offset, and dstOffset following ISO 8601 (https://en.wikipedia.org/wiki/ISO_8601) standard.",
          "example": "2022-09-28T19:20:30"
        }
      }
    },
    "metrics": {
      "type": "object",
      "properties": {
        "relevance": {
          "description": "Score value based on the number of travelers per year and per destination. Score is between 0 and 100, 100 being the value for the destination city with the highest value of travelers for the origin airport",
          "example": "100",
          "type": "integer"
        }
      }
    }
  }
}

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.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/airport-routes-locations"
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.