GET
locci/geo/region/
All regions. Filter by country using the country_slug query parameter.
Locci
Geography
Overview
Returns a paginated list of all administrative regions (states, provinces, territories) in the database. Each record includes the region name, ASCII name, code (e.g. US.CA for California), FIPS code, and the parent country. Regions correspond to the GeoNames admin1 level — the first administrative subdivision below the country level.
Request parameters
| Name |
Type |
In |
Required |
Description |
Example |
country_slug |
String |
Query |
Optional
|
URL-friendly slug of a country (e.g. canada, united-states). When supplied, the region list is filtered to return only regions belonging to that country. Obtain valid country slugs from the country list endpoint. |
canada |
Response fields
| Name |
Type |
Nullable |
Description |
Example |
code |
String |
Yes
|
GeoNames admin1 code combining country ISO and region identifier. |
CA.BC |
country |
String |
Yes
|
Hyperlinked URL to the parent country record. |
/locci/geo/country/38/ |
country_slug |
String |
—
|
URL-friendly name of the parent country. |
canada |
fips |
String |
Yes
|
FIPS code for the region. |
BC |
name |
String |
Yes
|
Official region name (state, province, or territory). |
British Columbia |
name_ascii |
String |
Yes
|
ASCII transliteration of the region name. |
British Columbia |
pk |
Integer |
—
|
Database primary key of the region record. |
492 |