{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/amadeus/refs/heads/main/json-schema/city-search-response-city-search-schema.json",
  "title": "response_citySearch",
  "description": "response_citySearch schema from City Search",
  "type": "object",
  "properties": {
    "warnings": {
      "type": "array",
      "items": {
        "type": "object",
        "description": "The Warning Definition",
        "title": "Warning",
        "properties": {
          "code": {
            "type": "integer",
            "description": "A machine-readable error code from the Canned Messages table, that will enable the API Consumers code to handle this type of error",
            "example": 1
          },
          "title": {
            "type": "string",
            "description": "An error title from the Canned Messages table with a 1:1 correspondence to the error code. This may be localized",
            "example": "string-value"
          },
          "detail": {
            "type": "string",
            "description": "An easy-to-read explanation specific to this occurrence of the problem. It should give the API consumer an idea of what went wrong and how to recover from it. Like the title, this field\u2019s value can be localized.",
            "example": "string-value"
          },
          "source": {
            "type": "object",
            "description": "The Warning Source Definition",
            "title": "Warning_Source",
            "properties": {
              "parameter": {
                "type": "string",
                "description": "The key of the URI path or query parameter that caused the error",
                "example": "string-value"
              },
              "pointer": {
                "type": "string",
                "description": "A JSON Pointer [RFC6901] to the associated entity in the request body that caused this error",
                "example": "string-value"
              },
              "example": {
                "type": "string",
                "description": "A sample input to guide the user when resolving this issu",
                "example": "string-value"
              }
            }
          }
        },
        "required": [
          "code",
          "title"
        ]
      }
    },
    "meta": {
      "type": "object",
      "description": "Meta information about the returned object(s) in \"data\"",
      "title": "Meta",
      "properties": {
        "count": {
          "type": "integer",
          "format": "int64",
          "description": "Total number of object(s) retrieved",
          "minimum": 0,
          "exclusiveMinimum": false,
          "example": 1
        },
        "links": {
          "type": "object",
          "title": "Links",
          "description": "Links related to the returned object(s)",
          "properties": {
            "self": {
              "type": "string",
              "format": "url",
              "description": "Link to the same page.",
              "example": "https://example.com/resource"
            }
          }
        }
      }
    },
    "data": {
      "type": "array",
      "items": {
        "title": "Location",
        "allOf": [
          {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "description": "Resource Type "
              },
              "relationships": {
                "type": "array",
                "items": {
                  "description": "Relationship allows to cross reference 2 entities via Link and/or id .",
                  "title": "Relationship",
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "id of the related resource"
                    },
                    "type": {
                      "type": "string",
                      "description": "Type of the related resource",
                      "example": "processed-dcs-passenger"
                    },
                    "href": {
                      "type": "string",
                      "format": "url",
                      "description": "URL value"
                    }
                  }
                }
              }
            }
          },
          {
            "type": "object",
            "description": "Description of a particular point or place in physical space",
            "title": "Location",
            "properties": {
              "subtype": {
                "type": "string",
                "description": "Location sub-type (e.g. airport, port, rail-station, restaurant, atm...)"
              },
              "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"
              },
              "address": {
                "type": "object",
                "description": "Address information",
                "title": "Address",
                "properties": {
                  "postalCode": {
                    "type": "string",
                    "description": "Example: 74130"
                  },
                  "countryCode": {
                    "type": "string",
                    "description": "ISO 3166-1 country code",
                    "pattern": "[a-zA-Z]{2}"
                  },
                  "stateCode": {
                    "type": "string",
                    "description": "State code (two character standard IATA state code)",
                    "pattern": "[a-zA-Z0-9]{1,2}"
                  }
                }
              },
              "geoCode": {
                "type": "object",
                "description": "Geographic coordinates describing the position of any location on the surface of Earth",
                "title": "GeoCode",
                "properties": {
                  "latitude": {
                    "type": "number",
                    "format": "float",
                    "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.",
                    "minimum": -90,
                    "exclusiveMinimum": false,
                    "maximum": 90,
                    "exclusiveMaximum": false,
                    "example": 48.85837
                  },
                  "longitude": {
                    "type": "number",
                    "format": "float",
                    "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.",
                    "minimum": -180,
                    "exclusiveMinimum": false,
                    "maximum": 180,
                    "exclusiveMaximum": false,
                    "example": 2.294481
                  }
                }
              }
            }
          }
        ],
        "description": ""
      }
    },
    "included": {
      "type": "object",
      "properties": {
        "airports": {
          "type": "object",
          "additionalProperties": {
            "title": "Location",
            "allOf": [
              {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string",
                    "description": "Resource Type "
                  },
                  "relationships": {
                    "type": "array",
                    "items": {
                      "description": "Relationship allows to cross reference 2 entities via Link and/or id .",
                      "title": "Relationship",
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "description": "id of the related resource"
                        },
                        "type": {
                          "type": "string",
                          "description": "Type of the related resource",
                          "example": "processed-dcs-passenger"
                        },
                        "href": {
                          "type": "string",
                          "format": "url",
                          "description": "URL value"
                        }
                      }
                    }
                  }
                }
              },
              {
                "type": "object",
                "description": "Description of a particular point or place in physical space",
                "title": "Location",
                "properties": {
                  "subtype": {
                    "type": "string",
                    "description": "Location sub-type (e.g. airport, port, rail-station, restaurant, atm...)"
                  },
                  "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"
                  },
                  "address": {
                    "type": "object",
                    "description": "Address information",
                    "title": "Address",
                    "properties": {
                      "postalCode": {
                        "type": "string",
                        "description": "Example: 74130"
                      },
                      "countryCode": {
                        "type": "string",
                        "description": "ISO 3166-1 country code",
                        "pattern": "[a-zA-Z]{2}"
                      },
                      "stateCode": {
                        "type": "string",
                        "description": "State code (two character standard IATA state code)",
                        "pattern": "[a-zA-Z0-9]{1,2}"
                      }
                    }
                  },
                  "geoCode": {
                    "type": "object",
                    "description": "Geographic coordinates describing the position of any location on the surface of Earth",
                    "title": "GeoCode",
                    "properties": {
                      "latitude": {
                        "type": "number",
                        "format": "float",
                        "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.",
                        "minimum": -90,
                        "exclusiveMinimum": false,
                        "maximum": 90,
                        "exclusiveMaximum": false,
                        "example": 48.85837
                      },
                      "longitude": {
                        "type": "number",
                        "format": "float",
                        "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.",
                        "minimum": -180,
                        "exclusiveMinimum": false,
                        "maximum": 180,
                        "exclusiveMaximum": false,
                        "example": 2.294481
                      }
                    }
                  }
                }
              }
            ],
            "description": ""
          }
        }
      }
    }
  }
}