← Release history

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 change

County 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.

Before
/district/08031
/state/CO/districts?country=US
result.district
result.district_name
API 2.2.0
/county/08031
/state/CO/counties?country=US
result.county
result.county_name

API reference

Read the upgrade guide to test a version in application code. Requests without a version follow the team setting in Settings → API version. A new release does not upgrade your existing team automatically.