Location Search (City, State, Region, or Country)

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Location name; fuzzy matched."
    },
    "type": {
      "enum": [
        "CITY",
        "STATE",
        "REGION",
        "COUNTRY"
      ],
      "type": "string",
      "description": "Restrict to one location level."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "locations": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "The matched location's display name, e.g. 'London'."
              },
              "permalink": {
                "type": "string",
                "description": "A stable, URL-safe slug identifying this specific location record, disambiguating same-named places, e.g. 'london-england' vs. 'london-ontario' vs. 'london-kentucky'."
              },
              "location_type": {
                "type": "string",
                "description": "One of CITY, STATE, REGION, COUNTRY."
              }
            },
            "additionalProperties": true
          },
          "description": "Empty array on a no-match search; one entry per matching location otherwise -- a search for 'London' returned 9 entries, including near-misses like 'Londonderry' and 'New London', not just exact name matches."
        },
        "totalCount": {
          "type": "number",
          "description": "9 on a 9-result name match, 0 on a no-match search."
        }
      },
      "additionalProperties": true
    },
    "meta": {
      "type": "object",
      "properties": {
        "page": {
          "type": "number",
          "description": "Observed as 0 on both real captures."
        },
        "page_size": {
          "type": "number",
          "description": "Observed as 1 on both real captures."
        }
      },
      "additionalProperties": true
    },
    "message": {
      "type": "string",
      "description": "A human-readable status string. Only observed when the search matched zero locations (e.g. 'No locations found matching your search'); absent from the response entirely when at least one location is returned."
    },
    "success": {
      "type": "boolean",
      "description": "true on both a match and a no-match search."
    }
  },
  "description": "The search result, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": true
}