🌍 Nager.Country – Worldwide Country Information

Nager.Country provides a comprehensive dataset of worldwide country information, designed for developers who need reliable and structured country-related data.

The dataset includes 250 countries and territories with detailed information such as:

• ✅ Official country names
• 🌐 ISO 3166 Alpha-2, Alpha-3, and numeric country codes
• 💱 Associated currencies and ISO 4217 currency codes
• 🌍 Continent and subregion classification
• 🌐 Country borders
• 🌏 Translations in multiple languages
• 🗣️ Official and spoken languages (ISO 639) (not yet available)

📦 Access & Installation

You can access the data in two ways:

• Via NuGet package – ideal for .NET applications
• As a downloadable ZIP archive containing structured JSON files (latest zip package)

🎯 Use Cases

Perfect for projects that require up-to-date and standardized country data, such as:

• International e-commerce systems
• Travel and booking platforms
• Localization (i18n) features
• Data validation and enrichment
• Geographic analytics and reporting

nuget

The project is available as NuGet packages for easy integration into any .NET application.

📚 Core Package – Nager.Country

🔗 View on NuGet.org →

PM> install-package Nager.Country

🌐 Optional Package – Nager.Country.Translation

Provides localized country names (translations based on the commonName in multiple languages).

🔗 View on NuGet.org →

PM> install-package Nager.Country.Translation

Examples of use

Get all available countries

Retrieve a full list of all 250 countries and territories.

var countryProvider = new CountryProvider();
var countries = countryProvider.GetCountries();

Lookup a country by its English name

Get detailed information by specifying the official English country name.

var countryProvider = new CountryProvider();
var countryInfo = countryProvider.GetCountryByName("Germany");
//countryInfo.Alpha2Code -> DE
//countryInfo.Alpha3Code -> DEU
//countryInfo.NumericCode -> 276
//countryInfo.Region -> Europe
//countryInfo.SubRegion -> WesternEurope
//countryInfo...

Lookup a country by localized name (with translation support)

Enables country name lookup using translations (e.g. "Germania" instead of "Germany").

➡️ Requires the translation package Nager.Country.Translation

var countryProvider = new CountryProvider();
var countryInfo = countryProvider.GetCountryByNameConsiderTranslation("Germania"); // <- Germany
//countryInfo.Alpha2Code -> DE
//countryInfo.Alpha3Code -> DEU
//countryInfo.NumericCode -> 276
//countryInfo.Region -> Europe
//countryInfo.SubRegion -> WesternEurope
//countryInfo...

Get a country's name in a specific language

Translate the official country name into a desired language.

➡️ Requires the translation package Nager.Country.Translation

var translationProvider = new TranslationProvider();
var translatedCountryName = translationProvider.GetCountryTranslatedName(Alpha2Code.DE, LanguageCode.EN);
//translatedCountryName -> Germany

Get all supported languages

List all language codes available for translation purposes. ➡️ Requires the translation package Nager.Country.Translation

var translationProvider = new TranslationProvider();
var languages = translationProvider.GetLanguages();

🌐 Related & Interesting Projects

Here are some useful projects that also provide country-related data, validation, or localization features:

Language	Project
*	mledoze countries
*	umpirsky country-list
*	dr5hn countries-states-cities-database
javascript	michaelwittig node-i18n-iso-countries
.net	anghelvalentin CountryValidator