Country Data API
Free download · JSON & CSV · CC BY 4.0

Country List & US States List
JSON and CSV Download

A clean list of 197 countries with ISO 3166-1 alpha-2 and alpha-3 codes, capitals, regions, currencies and languages — plus 194 states and provinces, including all 50 US states and DC. Preview it below and download it as JSON or CSV.

No sign-up and no API key needed for these files.

Download the files

Country list (ISO 3166-1)

197 rows. Fields: name, iso2, iso3, capital, region, currency, currency_name, languages, timezone.

Download countries JSON Download countries CSV

States & provinces list

194 rows, including all 50 US states and DC. Fields: name, code, country, country_iso2, capital, region.

Download states JSON Download states CSV

Licence: CC BY 4.0 — free to use with a link back to countrydataapi.com. CSV files are UTF-8 encoded.

Preview the data

Showing 197 of 197 rows.

List of countries with ISO 3166 codes. Column headers are buttons that sort the table.
Afghanistan AFAFGKabulAsiaAFN
Albania ALALBTiranaEuropeALL
Algeria DZDZAAlgiersAfricaDZD
Andorra ADANDAndorra la VellaEuropeEUR
Angola AOAGOLuandaAfricaAOA
Antigua and Barbuda AGATGSaint John'sAmericasXCD
Argentina ARARGBuenos AiresAmericasARS
Australia AUAUSCanberraOceaniaAUD
Austria ATAUTViennaEuropeEUR
Bahamas BSBHSNassauAmericasBSD
Bahrain BHBHRManamaAsiaBHD
Bangladesh BDBGDDhakaAsiaBDT
Barbados BBBRBBridgetownAmericasBBD
Belarus BYBLRMinskEuropeBYN
Belgium BEBELBrusselsEuropeEUR
Belize BZBLZBelmopanAmericasBZD
Benin BJBENPorto-NovoAfricaXOF
Bhutan BTBTNThimphuAsiaBTN
Bolivia BOBOLSucreAmericasBOB
Bosnia and Herzegovina BABIHSarajevoEuropeBAM
Botswana BWBWAGaboroneAfricaBWP
Brazil BRBRABrasíliaAmericasBRL
Brunei BNBRNBandar Seri BegawanAsiaBND
Bulgaria BGBGRSofiaEuropeBGN
Burkina Faso BFBFAOuagadougouAfricaXOF
Burundi BIBDIGitegaAfricaBIF
Cambodia KHKHMPhnom PenhAsiaKHR
Cameroon CMCMRYaoundéAfricaXAF
Canada CACANOttawaAmericasCAD
Cape Verde CVCPVPraiaAfricaCVE
Central African Republic CFCAFBanguiAfricaXAF
Chad TDTCDN'DjamenaAfricaXAF
Chile CLCHLSantiagoAmericasCLP
China CNCHNBeijingAsiaCNY
Colombia COCOLBogotáAmericasCOP
Comoros KMCOMMoroniAfricaKMF
Costa Rica CRCRISan JoséAmericasCRC
Côte d'Ivoire CICIVYamoussoukroAfricaXOF
Croatia HRHRVZagrebEuropeEUR
Cuba CUCUBHavanaAmericasCUP
Cyprus CYCYPNicosiaEuropeEUR
Czech Republic CZCZEPragueEuropeCZK
Democratic Republic of the Congo CDCODKinshasaAfricaCDF
Denmark DKDNKCopenhagenEuropeDKK
Djibouti DJDJIDjiboutiAfricaDJF
Dominica DMDMARoseauAmericasXCD
Dominican Republic DODOMSanto DomingoAmericasDOP
East Timor TLTLSDiliAsiaUSD
Ecuador ECECUQuitoAmericasUSD
Egypt EGEGYCairoAfricaEGP
El Salvador SVSLVSan SalvadorAmericasUSD
Equatorial Guinea GQGNQMalaboAfricaXAF
Eritrea ERERIAsmaraAfricaERN
Estonia EEESTTallinnEuropeEUR
Eswatini SZSWZMbabaneAfricaSZL
Ethiopia ETETHAddis AbabaAfricaETB
Fiji FJFJISuvaOceaniaFJD
Finland FIFINHelsinkiEuropeEUR
France FRFRAParisEuropeEUR
Gabon GAGABLibrevilleAfricaXAF
Gambia GMGMBBanjulAfricaGMD
Germany DEDEUBerlinEuropeEUR
Ghana GHGHAAccraAfricaGHS
Greece GRGRCAthensEuropeEUR
Grenada GDGRDSaint George'sAmericasXCD
Guatemala GTGTMGuatemala CityAmericasGTQ
Guinea GNGINConakryAfricaGNF
Guinea-Bissau GWGNBBissauAfricaXOF
Guyana GYGUYGeorgetownAmericasGYD
Haiti HTHTIPort-au-PrinceAmericasHTG
Honduras HNHNDTegucigalpaAmericasHNL
Hong Kong HKHKGHong KongAsiaHKD
Hungary HUHUNBudapestEuropeHUF
Iceland ISISLReykjavikEuropeISK
India ININDNew DelhiAsiaINR
Indonesia IDIDNJakartaAsiaIDR
Iran IRIRNTehranAsiaIRR
Iraq IQIRQBaghdadAsiaIQD
Ireland IEIRLDublinEuropeEUR
Israel ILISRJerusalemAsiaILS
Italy ITITARomeEuropeEUR
Jamaica JMJAMKingstonAmericasJMD
Japan JPJPNTokyoAsiaJPY
Jordan JOJORAmmanAsiaJOD
Kazakhstan KZKAZAstanaAsiaKZT
Kenya KEKENNairobiAfricaKES
Kiribati KIKIRTarawaOceaniaAUD
Kosovo XKXKXPristinaEuropeEUR
Kuwait KWKWTKuwait CityAsiaKWD
Kyrgyzstan KGKGZBishkekAsiaKGS
Laos LALAOVientianeAsiaLAK
Latvia LVLVARigaEuropeEUR
Lebanon LBLBNBeirutAsiaLBP
Lesotho LSLSOMaseruAfricaLSL
Liberia LRLBRMonroviaAfricaLRD
Libya LYLBYTripoliAfricaLYD
Liechtenstein LILIEVaduzEuropeCHF
Lithuania LTLTUVilniusEuropeEUR
Luxembourg LULUXLuxembourg CityEuropeEUR
Macao MOMACMacaoAsiaMOP
Madagascar MGMDGAntananarivoAfricaMGA
Malawi MWMWILilongweAfricaMWK
Malaysia MYMYSKuala LumpurAsiaMYR
Maldives MVMDVMaléAsiaMVR
Mali MLMLIBamakoAfricaXOF
Malta MTMLTVallettaEuropeEUR
Marshall Islands MHMHLMajuroOceaniaUSD
Mauritania MRMRTNouakchottAfricaMRU
Mauritius MUMUSPort LouisAfricaMUR
Mexico MXMEXMexico CityAmericasMXN
Micronesia FMFSMPalikirOceaniaUSD
Moldova MDMDAChisinauEuropeMDL
Monaco MCMCOMonacoEuropeEUR
Mongolia MNMNGUlaanbaatarAsiaMNT
Montenegro MEMNEPodgoricaEuropeEUR
Morocco MAMARRabatAfricaMAD
Mozambique MZMOZMaputoAfricaMZN
Myanmar MMMMRNaypyidawAsiaMMK
Namibia NANAMWindhoekAfricaNAD
Nauru NRNRUYarenOceaniaAUD
Nepal NPNPLKathmanduAsiaNPR
Netherlands NLNLDAmsterdamEuropeEUR
New Zealand NZNZLWellingtonOceaniaNZD
Nicaragua NINICManaguaAmericasNIO
Niger NENERNiameyAfricaXOF
Nigeria NGNGAAbujaAfricaNGN
North Korea KPPRKPyongyangAsiaKPW
North Macedonia MKMKDSkopjeEuropeMKD
Norway NONOROsloEuropeNOK
Oman OMOMNMuscatAsiaOMR
Pakistan PKPAKIslamabadAsiaPKR
Palau PWPLWNgerulmudOceaniaUSD
Palestine PSPSERamallahAsiaILS
Panama PAPANPanama CityAmericasPAB
Papua New Guinea PGPNGPort MoresbyOceaniaPGK
Paraguay PYPRYAsunciónAmericasPYG
Peru PEPERLimaAmericasPEN
Philippines PHPHLManilaAsiaPHP
Poland PLPOLWarsawEuropePLN
Portugal PTPRTLisbonEuropeEUR
Puerto Rico PRPRISan JuanAmericasUSD
Qatar QAQATDohaAsiaQAR
Republic of the Congo CGCOGBrazzavilleAfricaXAF
Romania ROROUBucharestEuropeRON
Russia RURUSMoscowEuropeRUB
Rwanda RWRWAKigaliAfricaRWF
Saint Kitts and Nevis KNKNABasseterreAmericasXCD
Saint Lucia LCLCACastriesAmericasXCD
Saint Vincent and the Grenadines VCVCTKingstownAmericasXCD
Samoa WSWSMApiaOceaniaWST
San Marino SMSMRSan MarinoEuropeEUR
São Tomé and Príncipe STSTPSão ToméAfricaSTN
Saudi Arabia SASAURiyadhAsiaSAR
Senegal SNSENDakarAfricaXOF
Serbia RSSRBBelgradeEuropeRSD
Seychelles SCSYCVictoriaAfricaSCR
Sierra Leone SLSLEFreetownAfricaSLL
Singapore SGSGPSingaporeAsiaSGD
Slovakia SKSVKBratislavaEuropeEUR
Slovenia SISVNLjubljanaEuropeEUR
Solomon Islands SBSLBHoniaraOceaniaSBD
Somalia SOSOMMogadishuAfricaSOS
South Africa ZAZAFPretoriaAfricaZAR
South Korea KRKORSeoulAsiaKRW
South Sudan SSSSDJubaAfricaSSP
Spain ESESPMadridEuropeEUR
Sri Lanka LKLKAColomboAsiaLKR
Sudan SDSDNKhartoumAfricaSDG
Suriname SRSURParamariboAmericasSRD
Sweden SESWEStockholmEuropeSEK
Switzerland CHCHEBernEuropeCHF
Syria SYSYRDamascusAsiaSYP
Taiwan TWTWNTaipeiAsiaTWD
Tajikistan TJTJKDushanbeAsiaTJS
Tanzania TZTZADodomaAfricaTZS
Thailand THTHABangkokAsiaTHB
Togo TGTGOLoméAfricaXOF
Tonga TOTONNuku'alofaOceaniaTOP
Trinidad and Tobago TTTTOPort of SpainAmericasTTD
Tunisia TNTUNTunisAfricaTND
Turkey TRTURAnkaraEuropeTRY
Turkmenistan TMTKMAshgabatAsiaTMT
Tuvalu TVTUVFunafutiOceaniaAUD
Uganda UGUGAKampalaAfricaUGX
Ukraine UAUKRKyivEuropeUAH
United Arab Emirates AEAREAbu DhabiAsiaAED
United Kingdom GBGBRLondonEuropeGBP
United States USUSAWashington, D.C.AmericasUSD
Uruguay UYURYMontevideoAmericasUYU
Uzbekistan UZUZBTashkentAsiaUZS
Vanuatu VUVUTPort VilaOceaniaVUV
Vatican City VAVATVatican CityEuropeEUR
Venezuela VEVENCaracasAmericasVES
Vietnam VNVNMHanoiAsiaVND
Yemen YEYEMSana'aAsiaYER
Zambia ZMZMBLusakaAfricaZMW
Zimbabwe ZWZWEHarareAfricaZWL

About these datasets

ISO 3166 country codes. Every country row carries the two-letter (iso2, ISO 3166-1 alpha-2) and three-letter (iso3, alpha-3) code, so you can use the file as a drop-in country dropdown, a lookup table for a database seed, or a CSV to join against your own data.

US states list in JSON. The states file includes all 50 US states plus the District of Columbia with their USPS two-letter codes and capitals, as well as the main subdivisions of other large countries. Filter by country_iso2 to get the list for a single country.

Attribution. The files are released under CC BY 4.0: free to use, including commercially, with a link back to countrydataapi.com.

Need the full dataset?

These downloads are a starter subset. The Country Data API serves the full hierarchy — all states and provinces, 150,000+ cities and 500,000+ postal codes, with extra fields such as phone codes, flags and postal code formats — always up to date, in JSON. Paid plans start at €5/month.

See pricing plans Read the API docs