TieredTravel

{
  "type": "object",
  "required": [
    "city"
  ],
  "properties": {
    "city": {
      "type": "string",
      "examples": [
        "lisbon",
        "barcelona"
      ],
      "description": "City name or slug, e.g. \"lisbon\" or \"Lisbon\"."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [],
  "properties": {
    "query": {
      "type": "string",
      "examples": [
        "Portugal",
        "Japan"
      ],
      "description": "Optional filter: a country, continent or name fragment. Omit for all 100."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "city"
  ],
  "properties": {
    "city": {
      "type": "string",
      "examples": [
        "lisbon"
      ],
      "description": "City name or slug."
    },
    "hours": {
      "enum": [
        3,
        6,
        12
      ],
      "type": "integer",
      "description": "Optional route length. Only 3, 6 and 12 exist; omit to get whatever the city has."
    }
  },
  "additionalProperties": false
}