Getting Started

npm install @koshmoney/countries

import { country, subdivision, postalCode } from '@koshmoney/countries';
 
// Look up any country by alpha-2, alpha-3, or numeric code
const us = country.whereAlpha2('US');
// { name: 'United States', alpha2: 'US', alpha3: 'USA', numeric: '840' }
 
// Get subdivisions (states, provinces, regions)
const california = subdivision.whereCode('US-CA');
// { code: 'US-CA', name: 'California', type: 'State', countryCode: 'US', ... }
 
// Validate postal codes
postalCode.isValid('US', '90210');     // true
postalCode.isValid('GB', 'SW1A 1AA');  // true

// Specialized module imports
import { currency } from '@koshmoney/countries/currency';
import { dialCode } from '@koshmoney/countries/dialCode';
import { geography } from '@koshmoney/countries/geography';
import { membership } from '@koshmoney/countries/membership';