Skip to content
List of all countries with names and ISO 3166-1 codes in all languages and data formats.
Find file
Pull request Compare This branch is 36 commits behind umpirsky:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Country List

List of all countries with names and ISO 3166-1 codes in all languages and all data formats.

Formats Available

  • Text
  • JSON
  • YAML
  • XML
  • HTML
  • CSV
  • SQL
    • MySQL
    • PostgreSQL
    • SQLite
    • SQL Server
  • PHP


All formats are also available in multiple languages, please find full language list here.

Where Does the Data Come From?

For now, I have implemented two data importers:

  • ICU (imports data from ICU)
  • CLDR (imports data from CLDR)

So, if country list changes in the future, it will be very easy to update our country list.


To build all available country-list data, execute the following commands.

Checkout the github repo:

$ git clone git://
$ cd country-list

On Debian/Ubuntu, execute:

$ sudo apt-get -y install php5 php5-intl 
$ curl -sS | php
$ php composer.phar install --dev # to install the runtime dependencies
$ php console list # to list all available console commands
$ php console build # to create all the nice country-list data formats

After this, you will get all the country-list files in the formats listed above.

This will generate about 110MB of data:

$ du -hs country/


To list the generated files, execute:

$ ls -1 country/*/*
Something went wrong with that request. Please try again.