Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
98 lines (77 sloc) 3.64 KB


World countries  Tweet

available in multiple languages, in SQL, JSON and CSV formats, with associated codes as defined by the ISO 3166 standard, and with national flags included


Constantly updated lists of world countries and associated alpha-2, alpha-3 and numeric codes as defined by the ISO 3166 standard published and maintained by the International Organization for Standardization, available in MySQL, JSON and CSV formats, in multiple languages and with national flags included.

The files contain:

  • the ISO 3166-1 numeric country codes
  • the ISO 3166 official short names in English1
  • the ISO 3166-1 alpha-2 two-letter country codes
  • the ISO 3166-1 alpha-3 three-letter country codes

1 for other languages the country names are in that particular language

The lists are currently available in 21 languages:

  • Arabic
  • Chinese
  • Czech
  • Dutch
  • English
  • French
  • German
  • Greek
  • Hungarian
  • Italian
  • Japanese
  • Lithuanian
  • Norwegian
  • Polish
  • Portuguese
  • Romanian
  • Russian
  • Slovak
  • Spanish
  • Thai
  • Ukrainian

Excerpt from the data/en/countries.sql file:

(250, 'France', 'fr', 'fra'),
(254, 'French Guiana', 'gf', 'guf'),
(258, 'French Polynesia', 'pf', 'pyf'),
(260, 'French Southern Territories', 'tf', 'atf'),
(266, 'Gabon', 'ga', 'gab'),
(270, 'Gambia', 'gm', 'gmb'),
(268, 'Georgia', 'ge', 'geo'),
(276, 'Germany', 'de', 'deu'),

Excerpt from the data/en/countries.csv file:

254,"French Guiana",gf,guf
258,"French Polynesia",pf,pyf
260,"French Southern Territories",tf,atf

Excerpt from the data/en/countries.json file:

{"id":254,"name":"French Guiana","alpha2":"gf","alpha3":"guf"},
{"id":258,"name":"French Polynesia","alpha2":"pf","alpha3":"pyf"},
{"id":260,"name":"French Southern Territories","alpha2":"tf","alpha3":"atf"},

The package also contains the national flags of each country as a 16x16, 24x24, 32x32, 48x48, 64x64 and 128x128 PNG images, courtesy of IconDrawer. The image files are named using the ISO 3166-1-alpha-2 code of the country they represent, for easily pairing flags with countries.


Country names in all languages are taken from Wikipedia.

Support the development of this project