TypeScriptZero DependenciesTree-ShakeableISO 3166

Countries (ISO 3166)
for JavaScript

249 countries. 5,000+ subdivisions. Postal codes, currencies, dial codes, geography, and EU/SEPA membership — in one tree-shakeable package.

249 Countries5,000+ Subdivisions150+ Postal Codes8KB Min Bundle·Updated March 2026

Get Started View on GitHub

🇯🇵

🇯🇵Japan

{ name: 'Japan', alpha3: 'JPN', numeric: '392' }

Everything You Need

One package replaces half a dozen country data libraries.

249 Countries

Full ISO 3166-1 with alpha-2, alpha-3, and numeric codes.

5,000+ Subdivisions

ISO 3166-2 states, provinces, regions, and territories.

Postal Codes

Validate ZIP codes, postcodes, PIN codes for 150+ countries.

Memberships

EU, SEPA, EEA, Eurozone, and Schengen membership checks.

Tree-Shakeable

Import only what you need — from 60KB down to 8KB.

TypeScript First

Full type definitions. Zero runtime dependencies for core.

Quick Start

Install and start querying country data in seconds.

$ npm install @koshmoney/countries

import { country } from '@koshmoney/countries';

const us = country.getCountry('US');
// { alpha2: 'US', alpha3: 'USA', numeric: '840',
//   name: 'United States of America', ... }

const all = country.getAllCountries();
// 249 countries

Import Only What You Need

Specialized modules are separate subpath exports — they never bloat your main bundle.

Currency@koshmoney/countries/currency

import { currency } from '@koshmoney/countries/currency';
currency.getCurrency('US');
// { code: 'USD', name: 'US Dollar', symbol: '$' }

Dial Codes@koshmoney/countries/dialCode

import { dialCode } from '@koshmoney/countries/dialCode';
dialCode.getDialCodes('US');
// ['+1']

Geography@koshmoney/countries/geography

import { geography } from '@koshmoney/countries/geography';
geography.getContinent('JP');
// 'Asia'

Membership@koshmoney/countries/membership

import { membership } from '@koshmoney/countries/membership';
membership.isEU('DE');
// true

Before and After

Replace multiple packages with one unified API.

Before — Multiple packages

// 3 packages, different APIs
import * as iso3166_1 from 'iso-3166-1';
import * as iso3166_2 from 'iso-3166-2';
import currencies from 'currency-codes';

// No TypeScript, no validation
const c = iso3166_1.whereAlpha2('US');
const s = iso3166_2.subdivision('US-CA');

After — One package

// One package, unified API
import { country, subdivision }
  from '@koshmoney/countries';
import { currency }
  from '@koshmoney/countries/currency';

const c = country.getCountry('US');
const s = subdivision.get('US-CA');
const usd = currency.getCurrency('US');

How It Compares

Feature comparison with popular alternatives.

Feature	@koshmoney/countries	i18n-iso-countries	countries-list	country-state-city
Countries	249	249	249	249
Subdivisions	5,000+	—	—	5,000+
Postal Codes	150+	—	—	—
Currencies			Partial
TypeScript	Built-in	@types	Built-in	Partial
Tree-Shaking	Per-country
Zero Deps	Core
Last Updated	March 2026	2023	2024	2024

Built for Every Use Case

From fintech compliance to SaaS country pickers.

Fintech & Banking

KYC, compliance, SEPA routing, currency conversion

E-Commerce

Address validation, shipping zones, tax regions

Crypto & Web3

Sanctions screening, geo-fencing, compliance

SaaS Platforms

Country pickers, localization, user onboarding

Start Building

Get ISO codes, subdivisions, currencies, and more — in one package.