Representation of a country.

Idenification Codes

  c.number # => "840"
  c.alpha2 # => "US"
  c.alpha3 # => "USA"
  c.gec    # => "US"
  c.un_locode # => "US"

Emoji

  c.emoji # => "🇺🇸"

Names and translations

  c.name # => "United States"
  c.unofficialNames # => ["United States of America", "Vereinigte Staaten von Amerika", "États-Unis", "Estados Unidos"]


  c = ISO3166.belgium
  c.localNames # => ["België", "Belgique", "Belgien"]

Subdivisions

  c.subdivisions

Location

  c.region # => "Americas"
  c.subregion # => "Northern America"

Telephone Routing

  c.countryCode # => "1"
  c.nationalDestinationCodeLengths # => [3]
  c.nationalNumberLengths # => [10]
  c.internationalPrefix # => "011"
  c.nationalPrefix # => "1"

Currency

  c.currencyCode # => "USD"

Address Formatting

These templates are compatible with the Liquid template system.

  c.addressFormat # => "{{recipient}}\n{{street}}\n{{city}} {{region_short}} {{postalcode}}\n{{country}}\n"

Representation of a subdivision.

A list of all countries.

Find a country by it's alpha2 code.

  ISO3166.fromAlpha2 "US" # => Just { name = "United States", alpha2 = "US", alpha3 = "USA", ... }

Find a subdivision by it's code.

  ISO3166.findSubdivisionByCode ISO3166.countryUS "NY" # => Just { name = "New York", code = "NY", ... }

Afghanistan

Albania

Algeria

American Samoa

Andorra

Angola

Anguilla

Antarctica

Antigua and Barbuda

Argentina

Armenia

Aruba

Australia

Austria

Azerbaijan

Bahamas

Bahrain

Bangladesh

Barbados

Belarus

Belgium

Belize

Benin

Bermuda

Bhutan

Bolivia (Plurinational State of)

Bonaire, Sint Eustatius and Saba

Bosnia and Herzegovina

Botswana

Bouvet Island

Brazil

British Indian Ocean Territory

Brunei Darussalam

Bulgaria

Burkina Faso

Burundi

Cabo Verde

Cambodia

Cameroon

Canada

Cayman Islands

Central African Republic

Chad

Chile

China

Christmas Island

Cocos (Keeling) Islands

Colombia

Comoros

Congo

Congo (Democratic Republic of the)

Cook Islands

Costa Rica

Croatia

Cuba

Curaçao

Cyprus

Czech Republic

Côte d'Ivoire

Denmark

Djibouti

Dominica

Dominican Republic

Ecuador

Egypt

El Salvador

Equatorial Guinea

Eritrea

Estonia

Ethiopia

Falkland Islands (Malvinas)

Faroe Islands

Fiji

Finland

France

French Guiana

French Polynesia

French Southern Territories

Gabon

Gambia

Georgia

Germany

Ghana

Gibraltar

Greece

Greenland

Grenada

Guadeloupe

Guam

Guatemala

Guernsey

Guinea

Guinea-Bissau

Guyana

Haiti

Heard Island and McDonald Islands

Holy See

Honduras

Hong Kong

Hungary

Iceland

India

Indonesia

Iran (Islamic Republic of)

Iraq

Ireland

Isle of Man

Israel

Italy

Jamaica

Japan

Jersey

Jordan

Kazakhstan

Kenya

Kiribati

Korea (Democratic People's Republic of)

Korea (Republic of)

Kuwait

Kyrgyzstan

Lao People's Democratic Republic

Latvia

Lebanon

Lesotho

Liberia

Libya

Liechtenstein

Lithuania

Luxembourg

Macao

Madagascar

Malawi

Malaysia

Maldives

Mali

Malta

Marshall Islands

Martinique

Mauritania

Mauritius

Mayotte

Mexico

Micronesia (Federated States of)

Moldova (Republic of)

Monaco

Mongolia

Montenegro

Montserrat

Morocco

Mozambique

Myanmar

Namibia

Nauru

Nepal

Netherlands

New Caledonia

New Zealand

Nicaragua

Niger

Nigeria

Niue

Norfolk Island

North Macedonia

Northern Mariana Islands

Norway

Oman

Pakistan

Palau

Palestine, State of

Panama

Papua New Guinea

Paraguay

Peru

Philippines

Pitcairn

Poland

Portugal

Puerto Rico

Qatar

Romania

Russian Federation

Rwanda

Réunion

Saint Barthélemy

Saint Helena, Ascension and Tristan da Cunha

Saint Kitts and Nevis

Saint Lucia

Saint Martin (French part)

Saint Pierre and Miquelon

Saint Vincent and the Grenadines

Samoa

San Marino

Sao Tome and Principe

Saudi Arabia

Senegal

Serbia

Seychelles

Sierra Leone

Singapore

Sint Maarten (Dutch part)

Slovakia

Slovenia

Solomon Islands

Somalia

South Africa

South Georgia and the South Sandwich Islands

South Sudan

Spain

Sri Lanka

Sudan

Suriname

Svalbard and Jan Mayen

Sweden

Switzerland

Syrian Arab Republic

Taiwan, Province of China

Tajikistan

Tanzania, United Republic of

Thailand

Timor-Leste

Togo

Tokelau

Tonga

Trinidad and Tobago

Tunisia

Turkey

Turkmenistan

Turks and Caicos Islands

Tuvalu

Uganda

Ukraine

United Arab Emirates

United Kingdom of Great Britain and Northern Ireland

United States Minor Outlying Islands

United States of America

Uruguay

Uzbekistan

Vanuatu

Venezuela (Bolivarian Republic of)

Viet Nam

Virgin Islands (British)

Virgin Islands (U.S.)

Wallis and Futuna

Western Sahara

Yemen

Zambia

Zimbabwe

eSwatini

Åland Islands