API 2.2.0
County names across location APIs
Use County consistently for counties and comparable administrative areas. Earlier contracts retain their existing District routes and fields.
What changes
County routes and references
Breaking changeCounty lookup uses /county/{code}; State lists use /state/{code}/counties. The reference fields become county, county_name and county_name_local, and list results use counties. City capital_of uses county for a county seat. Native place codes, local types, electoral records and depth placement stay unchanged. Full State responses rename iso_subdivision to iso_code without changing its value. County lookup and State county-list items add nullable iso_code for exact recorded ISO 3166-2 assignments. Country state lists and linked county references keep their existing shapes.
/district/08031
/state/CO/districts?country=US
result.district
result.district_name/county/08031
/state/CO/counties?country=US
result.county
result.county_name