List cities
list_citiesRead-onlyIdempotent
Use this when someone asks which cities WonderKit covers or needs a valid city key. Lists cities that have a published city guide of real things to do, with their keys. Reads public guides only; it cannot plan, save, or look up a private trip.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hint | No | ||
| note | Yes | Read-only reminder; not user content | |
| found | No | false when the lookup did not resolve | |
| cities | No | ||
| reason | No | unknown_city, region_not_city, no_city_guide, no_itineraries_for_city, ambiguous_city, no_published_guide, no_matches, unknown_itinerary, lookup_failed, … | |
| region | No | The state, country, or area the city ask was read as | |
| matches | No | Candidate cities when the name is ambiguous | |
| nearest | No | Covered cities in or near the asked-for area. Not the city that was asked for | |
| planUrl | No | Guest planner link for the destination as asked; it plans any city | |
| truncated | No | ||
| suggestions | No | Near-miss spellings, or same-name cities elsewhere, when the name is unknown | |
| itinerariesUrl | No | WonderKit itineraries for this city | |
| planDescription | No | One line saying what planUrl opens |