Post

Where can I get list of countries and there state provinces?

A free, automatically updated list of all countries with their states and provinces, ready to use in your project as JSON.

Posted Updated
JSON snippet from the countries gist showing a country with its ISO code and nested list of states and provinces
JSON snippet from the countries gist showing a country with its ISO code and nested list of states and provinces
By Manish Tiwari
1 min read
Where can I get list of countries and there state provinces?

Last year when I was working on a project I also came across same question, I did some research I manage to find few sources but all of them were outdated so I decided to create my own gist for that.

this contains all the countries and there states and this list will update automatically every month so you don’t have to worry about outdated data.

I am using geonames dumps to create this gist so if you find any incorrect data you can update at geonames side and it will reflect in next release.

Here is the JSON shape each country entry follows in the gist, with its ISO codes and nested list of states/provinces:

JSON shape of a country entry with ISO codes and nested states/provinces from the gist Each country object carries name, iso2, iso3, and a states array - use state_code to match a province/state back to its parent country.

Here you can find the gist.

cloud, gist
Countries Geoname Gist
This post is licensed under CC BY 4.0 by the author.