Country Standard Numbers

JavaScript (TypeScript) package to validate most all national numbers, with a focus on VAT, Person and Tax identifiers.

Quick start

import { stdnum } from 'stdnum';

console.log(stdnum.BR.cpf.name); // 'Brazilian National Identifier',
console.log(stdnum.BR.cpf.localName); // 'Cadastro de Pessoas Físicas',
console.log(stdnum.BR.cpf.abbreviation); // 'CPF',

const {
    isValid, // is false
    error, // InvalidLength: The number has an invalid length...
} = stdnum.BR.cpf.validate('xyzzy');

const {
    isValid, // true
    compact, // '39053344705'
    isIndividual, // true
    isEntity, // false
} = stdnum.BR.cpf.validate("390.533.447-05");

All country validators are in the "namespace" of the ISO country code.

Examples and formats

Each validator also lists example numbers and the shape of its formatted output, for placeholder text ("e.g. 390.533.447-05") or input masks:

console.log(stdnum.BR.cpf.examples); // ['39053344705']
console.log(stdnum.BR.cpf.formats); // ['nnn.nnn.nnn-nn']
console.log(stdnum.BR.cpf.format(stdnum.BR.cpf.examples[0])); // '390.533.447-05'

examples are valid numbers in compact form. formats describe what format() returns, in IBAN registry style: n is a digit, a an upper case letter (A-Z), c a digit or upper case letter, and any other character is literal (so CHE-nnn.nnn.nnn starts with the letters CHE). A number that comes in several shapes, such as different lengths, has one pattern per shape. The patterns describe shape only: a number that fits a pattern can still fail validate(), for example on its check digit.

Bundle size: tree-shakeable imports

The stdnum object eagerly references every country, so importing it bundles all of them (~200KB minified). If you only need a few validators, use either of these forms instead:

// Named country exports — tree-shakeable, bundlers drop unused countries
import { GB, BR } from 'stdnum';

GB.nino.validate('AB123456C');
BR.cpf.validate('390.533.447-05');

// Or import a single validator via its subpath
import { validate } from 'stdnum/gb/nino';

validate('AB123456C');

Subpaths follow the source layout: stdnum/<country>/<number> (e.g. stdnum/it/codicefiscale), and stdnum/<country> for a whole country's validators.

Tree-shaking the root stdnum entry works because package.json declares "sideEffects": false: anything you import from it that you don't use, such as the stdnum object or the validator tables below, can be dropped by the bundler.

Validating by country code

When the country is only known at runtime, these functions pick the validators for an ISO 3166-1 alpha-2 country code (case-insensitive):

import { validatePerson, validateEntity, validateVat } from 'stdnum';

validatePerson('BR', '390.533.447-05'); // personal ID numbers
validateEntity('US', '12-3456789'); // business and tax numbers
validateVat('DE', 'DE136695976'); // VAT numbers

Each returns { checked: true, isValid, matchedValidators } when it knows the country, and { checked: false } when it does not.

validateVat covers the countries in the euVat table: the EU member states plus some non-EU countries (such as AD and CH). It only pulls in those VAT validators, so it adds far less to a bundle than validateEntity, which references every country's business validators.

Supported Countries and Numbers

How you can help! This library currently support about half the countries in the world. It would be great if we can get to 100%. Submit an issue with any reference documentation and I'll do my best to integrate it, bonus points if you can get detailed descriptions of checksums or other validation criteria.

| Country | Code | Name | Group | Meaning | | ---------------------- | ---- | --------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------- | | Andorra | AD | NRT | Tax | Tax Register Identifier (Número de Registre Tributari) | | Angola | AO | BI | Person | Angolan Identity Card (Bilhete de Identidade) | | Angola | AO | NIF | Tax | Angolan Tax Identification Number (Número de Identificação Fiscal) | | Albania | AL | NIPT | Vat | Albanian Vat Identifier (Numri i Identifikimit për Personin e Tatueshëm) | | Anguilla | AI | TIN | Tax | Tax Identification Number | | Argentina | AR | CBU | Bank | Single Banking Code (Clave Bancaria Uniforme) | | Argentina | AR | CUIT | Tax | Unique Tax Identification Code (Código Único de Identificación Tributaria) | | Argentina | AR | DNI | Person | National Identity Document (Documento Nacional de Identidad) | | Austria | AT | Businessid | Company | Austrian Company Register Number | | Austria | AT | TIN | Tax | Austrian tax identification number (Abgabenkontonummer) | | Austria | AT | UID | VAT | Austrian VAT number (Umsatzsteuer-Identifikationsnummer) | | Austria | AT | VNR | Person | Austrian social security number(Versicherungsnummer) | | Australia | AU | ABN | Company | Australian Business Number | | Australia | AU | ACN | Company | Australian Company Number | | Australia | AU | TFN | Tax/Person/Company | Australian Tax File Number | | Bosnia and Herzegovina | BA | JMBG | Person | Unique Master Citizen Number | | Belize | BZ | TIN | Person/Company | Brazilian Tax ID () | | Belgium | BE | BIS | Person | Belgian Number for Foreigners | | Belgium | BE | INSZ, NISS | Person | Belgian Social Security Identification Number (Identificatienummer van de Sociale Zekerheid, Numéro d'Identification Sécurité Sociale) | | Belgium | BE | NN | Person | Belgian National Number (Numéro National) | | Belgium | BE | VAT | Company | Belgian Enterprise Number | | Bulgaria | BG | EGN | Person | ЕГН, Единен граждански номер, Bulgarian personal identity codes | | Bulgaria | BG | PNF | Person | PNF (ЛНЧ, Личен номер на чужденец, Bulgarian number of a foreigner). | | Bulgaria | BG | VAT | Company | Идентификационен номер по ДДС, Bulgarian VAT number | | Bolivia | BO | CI | Person | Person Identifier (Cédula de Identidad) | | Brazil | BR | CPF | Person | Brazilian identity number (Cadastro de Pessoas Físicas) | | Brazil | BR | CNPJ | Company | Brazilian company number (Cadastro Nacional da Pessoa Jurídica) | | Belarus | BY | UNP | Person/Company | Учетный номер плательщика, the Belarus VAT number | | Canada | CA | BC_BHN | Person | British Columbia Personal Health Number | | Canada | CA | BN | Company | Company Identifier (Canadian Business Number) | | Canada | CA | GST | Company | Goods and service Tax Number | | Canada | CA | PST | Company | Provincial Service Tax Number | | Canada | CA | QST | Company | Quebec Service Tax Number | | Canada | CA | SIN | Person | Person Identifier (Social Insurance Number) | | Cuba | CU | NI | Person | Número de identidad, Cuban identity card numbers | | Cyprus | CY | VAT | Company | Αριθμός Εγγραφής Φ.Π.Α. (Cypriot VAT number) | | Czech Republic | CZ | DIC | Vat | Daňové identifikační číslo, Czech VAT number | | Czech Republic | CZ | ICO | Company | Identifikační číslo osoby, Czech Company Identification Number | | Czech Republic | CZ | RC | Person | Rodné číslo, the Czech birth number | | Swisserland | CH | SSN | Person | Swiss social security number ("Sozialversicherungsnummer") | | Swisserland | CH | UID | Company | Unternehmens-Identifikationsnummer, Swiss business identifier | | Swisserland | CH | VAT | Company | Mehrwertsteuernummer, the Swiss VAT number | | Chile | CL | RUT | Tax | Tax Identifier (Rol Unico Tributario) [RUN] | | China | CN | RIC | Person | Person Identifier (Chinese Resident Identity Card Number) | | China | CN | USCC | Company | Company Identifier (Unified Social Credit Code, 统一社会信用代码, China tax number) | | Columbia | CO | NIT | Tax | Tax Identifier (Número de Identificación Tributaria) | | Costa Rica | CR | CPF | Person | Person Identifier (Cédula de Persona Física) | | Costa Rica | CR | CPJ | Company | Company Identifier (Cédula de Persona Jurídica) | | Costa Rica | CR | CR | Person | Person Identifier (Cédula de Residencia) | | Germany | DE | IDNR | Person | Steuerliche Identifikationsnummer, German personal tax number | | Germany | DE | Passport | Person | Passport Number | | Germany | DE | STNR | Company | Steuernummer, German tax number | | Germany | DE | SVNR | Person | Sozialversicherungsnummer, German social security / pension insurance number number | | Germany | DE | VAT | Company | Vat identifier | | Denmark | DK | VAT | Company | Momsregistreringsnummer, Danish VAT number | | Dominican Republic | DO | CEDULA | Person | Person Identifier (Cédula de Residencia) | | Dominican Republic | DO | NCF | Vat | Tax Receipt Number (Números de Comprobante Fiscal) | | Dominican Republic | DO | RNC | Tax | Person Identifier (Registro Nacional del Contribuyente) | | Algeria | DZ | NIF | Person/Company | Numéro d'Identification Fiscale, Algeria tax number | | Ecuador | EC | CI | Person | Ecuadorian person identifier (Cédula de identidad) | | Estonia | EE | IK | Person | Isikukood (Estonian Personcal ID number). | | Estonia | EE | KMKR | Company | KMKR (Käibemaksukohuslase, Estonian VAT number) | | Estonia | EE | Registrikood | Company | Registrikood (Estonian organisation registration code) | | Egypt | EG | TN | Company | Tax Registration Number (الرقم الضريبي, Egypt tax number) | | Ecuador | EC | RUC | Tax/Vat | Ecuadorian company tax number (Registro Único de Contribuyentes) | | El Salvador | SV | NIT | Tax | Tax Identifier (Número de Identificación Tributaria) | | Finland | FI | ALV | Company | ALV nro (Arvonlisäveronumero, Finnish VAT number) | | Finland | FI | HETU | Person | HETU (Henkilötunnus, Finnish personal identity code) | | Finland | FI | YTUNNUS | Company | Y-tunnus (Finnish business identifier) | | Faroe Islands | FO | VN | Company/Person | Vinnutal, Faroe Islands tax number | | France | FR | NIF | Person | NIF (Numéro d'Immatriculation Fiscale, French tax identification number) | | Great Britain | GB | NINO | Person | NINO (United Kingdom National Insurance Number) | | Great Britain | GB | UTR | Person | UTR (United Kingdom Unique Taxpayer Reference) | | Great Britain | GB | VAT | Company | VAT (United Kingdom (and Isle of Man) VAT registration number) | | Ghana | GH | TIN | Person/Company | Taxpayer Identification Number, Ghana tax number | | Guinea | GN | NIFP | Person/Company | Numéro d'Identification Fiscale Permanent, Guinea tax number | | Greece | GR | AMKA | Company | AMKA (Αριθμός Μητρώου Κοινωνικής Ασφάλισης, Greek social security number) | | Guatemala | GT | CUI | Person | Guatemala person (Código Único de Identificación) | | Guatemala | GT | NIT | Company | Guatemala company tax number (Número de Identificación Tributaria) | | Greece | GR | VAT | Company | FPA, ΦΠΑ, ΑΦΜ (Αριθμός Φορολογικού Μητρώου, the Greek VAT number) | | France | FR | NIR | Person | NIR (French personal identification number) | | France | FR | SIREN | Company | SIREN (a French company identification number) | | France | FR | SIRET | Company | SIRET (a French company establishment identification number) | | France | FR | TVA | Vat | VAT Identifier | | Croatia | HR | OIB | Person | Osobni identifikacijski broj, Croatian identification number | | Hong Kong | HK | HKID | Person | Hong Kong Identity Card | | Hungaria | HU | ANUM | Vat | ANUM (Közösségi adószám, Hungarian VAT number) | | Iceland | IS | KENNITALA | Person/Company | Icelandic personal and organisation identity code | | Iceland | IS | VSK | Vat | Virðisaukaskattsnúmer, Icelandic VAT number | | Indonesia | ID | NIK | Person | NIK (Nomor Induk Kependudukan, Indonesian identity number). | | Indonesia | ID | NPWP | Person/Company | NPWP (Nomor Pokok Wajib Pajak, Indonesian VAT Number). | | Ireland | IE | PPS | Person | Personal Public Service Number, Irish personal number | | Ireland | IE | VAT | Tax/Vat | Ireland Value Added Tax ID | | India | IN | AADHAAR | Company | Indian digital resident personal identity number | | India | IN | EPIC | Person | Electoral Photo Identity Card, Indian Voter ID | | India | IN | GSTIN | Vat | Goods and Services Tax identification number, Indian VAT number | | India | IN | PAN | Person | Permanent Account Number, Indian income tax identifier | | India | IN | VIN | Person | Indian personal virtual identity number | | Israel | IL | IDNR | Person | Identity Number (Mispar Zehut, מספר זהות, Israeli identity number) | | Israel | IL | HR | Company | Company Number (מספר חברה, or short ח.פ. Israeli company number) | | Italy | IT | AIC | Drug | Italian code for identification of drugs | | Italy | IT | CODICEFISCALE | Person | Codice Fiscale (Italian tax code for individuals) | | Italy | IT | IVA | Vat | Partita IVA (Italian VAT number) | | Liechtenstein | LI | PEID | Person/Company | Personenidentifikationsnummer | | Lithuanian | LT | ASMENS | Person | Asmens kodas (Person Number) | | Lithuanian | LT | PVM | Vat | Pridėtinės vertės mokestis mokėtojo kodas | | Luxembourgian | LU | TVA | Vat | taxe sur la valeur ajoutée | | Latvian | LV | PVN | Person/Vat | Pievienotās vērtības nodokļa | | Morocco | MA | ICE | Company | Identifiant Commun de l'Entreprise, Moroccan new registration number | | Macedonia | MK | EDB | Vat | Едниствен Даночен Број, North Macedonia tax number | | Macedonia | MK | JMBG | Person | Unique Master Citizen Number (Единствен матичен број на граѓанинот) | | Monaco | MC | TVA | Vat | taxe sur la valeur ajoutée, Monacan VAT number | | Moldavia | MD | IDNO | Vat | Moldavian VAT number | | Malta | MT | VAT | Vat | Maltese VAT number | | Mauritius | MU | NID | Person | ID number (Mauritian national identifier) | | Japan | JP | CN | Company | 法人番号, hōjin bangō, Japanese Corporate Number | | Kenya | KE | PIN | Person/Company | Personal Identification Number, Kenya tax number | | South Korea | KR | BRN | Company | 사업자 등록 번호, South Korea Business Registration Number) | | South Korea | KR | RRN | Person | South Korean resident registration number | | Mexico | MX | RFC | Tax/Vat | Tax Identifier (Registro Federal de Contribuyentes) | | Mexico | MX | CURP | Person | Individual Identifier (Clave Única de Registro de Población) | | Mexico | MX | CLABE | Bank | Bank Account (Clave Bancaria Estandarizada) | | Montenegro | ME | JMBG | Person | Unique Master Citizen Number | | Montenegro | ME | PIB | Tax/Vat | Poreski Identifikacioni Broj, Montenegro tax number | | Mozambique | MZ | BI | Person | Bilhete de Identidade, Mozambican national identification number | | Mozambique | MZ | NUIT | Tax/Vat | Número Único de Identificação Tributária, Mozambican tax identifier number | | Malaysia | MY | NRIC | Person | Malaysian National Registration Identity Card Number | | Netherlands | NL | BSN | Person | Burgerservicenummer, the Dutch citizen identification number | | Netherlands | NL | BTW | Vat | Btw-identificatienummer (Omzetbelastingnummer, the Dutch VAT number) | | Netherlands | NL | Onderwijsnummer | Person | Onderwijsnummer (the Dutch student identification number) | | New Zealand | NZ | IRD | Person/Company | New Zealand Inland Revenue Department (Te Tari Tāke) number | | New Zealand | NZ | BANK | Bank | New Zealand Bank Account numbers - checkdigit | | Norway | NO | Fodsels | Person | Fødselsnummer (Norwegian birth number, the national identity number) | | Norway | NO | Konto | Bank | Konto nr. (Norwegian bank account number) | | Norway | NO | MVA | Vat | Merverdiavgift, Norwegian VAT number | | Norway | NO | Orgnr | Company | Organisasjonsnummer, Norwegian organisation number | | Paraguay | PY | RUC | Tax/Vat | Tax Identifier (Registro Único de Contribuyentes) | | Peru | PE | CUI | Person | Person Identifier (Cédula Única de Identidad) | | Peru | PE | RUC | Tax/Vat | Tax Identifier (Registro Único de Contribuyentes) | | Peru | PE | CE | Person | Person Identifier (Carné de Extranjería) | | Pakistan | PK | CNIC | Person | National Identity Card | | Pakistan | PK | NTN | Company | Tax Identification Number | | Poland | PL | NIP | Vat | Numer Identyfikacji Podatkowej, Polish VAT number | | Poland | PL | PESEL | Person | Polish national identification number | | Poland | PL | REGON | Company | Rejestr Gospodarki Narodowej, Polish register of economic units | | Portugual | PT | CC | Person/Company | Número de Cartão de Cidadão, Portuguese Identity number | | Portugual | PT | NIF | Vat | Número de identificação fiscal, Portuguese VAT number | | Russia | RU | INN | Tax/Vat | Tax Identifier (Идентификационный номер налогоплательщика) | | Romania | RO | CF | Vat | Cod de înregistrare în scopuri de TVA, Romanian VAT number | | Romania | RO | CNP | Person | Cod Numeric Personal, Romanian Numerical Personal Code) | | Romania | RO | CUI | Tax | Codul Unic de Înregistrare, Romanian company identifier | | Romania | RO | ONRC | Company | Ordine din Registrul Comerţului, Romanian Trade Register identifier | | San Marino | SM | COE | Company | Codice operatore economico, San Marino national tax number | | Serbia | RS | PIB | Vat | Poreski identifikacioni broj Tax identification number | | Serbia | RS | JMBG | Person | Unique Master Citizen Number (Jedinstveni matični broj građana) | | Sweden | SE | ORGNR | Company | Organisationsnummer, Swedish company number | | Sweden | SE | PERSONNUMMER | Person | Personnummer (Swedish personal identity number) | | Sweden | SE | VAT | Vat | VAT (Moms, Mervärdesskatt, Swedish VAT number) | | Singapore | SG | UEN | Company | Singapore's Unique Entity Number | | Thailand | TH | IDNR | Person | Thai National ID (บัตรประจำตัวประชาชนไทย) | | Thailand | TH | MOA | Company | Thailand Memorandum of Association Number | | Thailand | TH | TIN | Company/Person | Thai Tax ID (Moa or Idnr) | | Tunisia | TN | MF | Vat | Matricule Fiscal, Tunisia tax number | | Taiwan | TW | BAN | Company | Taiwanese Unified Business Number (統一編號) | | Taiwan | TW | NATID | Person | National ID Card Number | | Taiwan | TW | TAX_CODE | Person | Tax Code | | Taiwan | TW | UBN | Company | Unified Business Number, 統一編號, Taiwanese tax number | | Taiwan | TW | UI | Person | UI Number | | Turkey | TR | TCKIMLIK | Person | Türkiye Cumhuriyeti Kimlik Numarası (Personal ID) | | Turkey | TR | VKN | Tax | Vergi Kimlik Numarası, Turkish tax identification number | | Slovenia | SI | DDV | Vat | ID za DDV (Davčna številka, Slovenian VAT number) | | Slovenia | SI | JMBG | Person | Unique Master Citizen Number (Enotna matična številka občana) | | Slovakia | SK | DPH | Vat | IČ DPH (IČ pre daň z pridanej hodnoty, Slovak VAT number) | | Slovakia | SK | RC | Person | RČ (Rodné číslo, the Slovak birth number) | | Spain | ES | CIF | Tax/Vat | Tax Identifier (Código de Identificación Fiscal) | | Spain | ES | DNI | Person | Identity code (Documento Nacional de Identidad) | | Spain | ES | NIE | Person | Identity code foreigner (Número de Identificación de Extranjero) | | Spain | ES | NIF | Tax | Tax Identifier (Número de Identificación Fiscal) | | Spain | ES | NSS | Person | El número de Seguridad Social, Social Security Number | | Sri Lanka | LK | NIC | Person | NIC Number | | Uruguay | UY | RUT | Tax/Vat | Tax Identifier (Registro Único Tributario) | | Uruguay | UY | CEDULA | Person | Person Identifier (Cédula de Residencia) | | Uruguay | UY | NIE | Person | ForeignersI identification Number | | Ukraine | UA | RNTRC | Person | КПП, RNTRC (Individual taxpayer registration number in Ukraine) | | Ukraine | UA | EDRPOU | Company | ЄДРПОУ, EDRPOU (Identifier for enterprises and organizations in Ukraine) | | United States | US | EIN | Tax/Company | Tax Identifier (Employer Identification Number) | | United States | US | SSN | Tax/Individual | Tax Identifier (Social Security Number) | | Venezuelan | VE | RIF | Vat | Vat Identifier (Registro de Identificación Fiscal) | | Vietnam | VN | MST | Company | Mã số thuế, Vietnam tax number | | South Africa | ZA | IDNR | Person | ID number (South African Identity Document number). | | South Africa | ZA | TIN | Person/Company | TIN (South African Tax Identification Number). | | South Africa | ZA | VAT | Company | VAT (South African Value Added Tax Number). |

Passport Number Validation

This library now supports passport number validation for 136 countries. Each passport validator follows the same interface as other validators and validates passport number formats based on country-specific patterns.

Quick Example

import { stdnum } from 'stdnum';

// Validate Brazilian passport
const brazilResult = stdnum.BR.passport.validate('AB123456');
console.log(brazilResult.isValid); // true if format is correct

// Validate US passport
const usResult = stdnum.US.passport.validate('123456789');
console.log(usResult.isValid); // true if format is correct

// Validate German passport (with checksum support)
const germanResult = stdnum.DE.passport.validate('C01X00T47');
console.log(germanResult.isValid); // true if format and checksum are correct

Convenience API

You can also use the convenience API to validate passport numbers by country code:

import { validatePassport, formatPassport, compactPassport } from 'stdnum';

// Validate by country code
const result = validatePassport('BR', 'AB123456');
console.log(result.checked, result.isValid); // true true

// Country without passport validator: not checked, like validatePerson
console.log(validatePassport('XK', 'AB123456')); // { checked: false }

// Format by country code
const formatted = formatPassport('US', '123456789');
console.log(formatted); // '123456789'

// Compact by country code
const compacted = compactPassport('DE', 'C01X00T47');
console.log(compacted); // 'C01X00T47'

Supported Passport Validators

The following countries have passport number validators implemented:

| Country | Code | Passport Format | |---------|------|----------------| | Andorra | AD | 1 letter + 7 digits | | Afghanistan | AF | 1 letter + 8 digits | | Antigua and Barbuda | AG | 1 letter + 6 digits | | Anguilla | AI | pattern ^\d{9}$\|^[A-Z]{2}\d{6}$ | | Albania | AL | 2 letters + 7 digits | | Armenia | AM | 2 letters + 7 digits | | Angola | AO | 1-2 letters + 7 digits | | Argentina | AR | 3 letters + 6 digits | | Austria | AT | 1-2 letters + 7 digits | | Australia | AU | pattern ^[A-Z]\d{7}$\|^[A-Z]{2}\d{7}$ | | Azerbaijan | AZ | pattern ^[A-Z]\d{8}$\|^[A-Z]{2}\d{7}$ | | Bosnia and Herzegovina | BA | pattern ^[A-Z]\d{8}$\|^\d{9}$ | | Barbados | BB | 1 letter + 6 digits | | Bangladesh | BD | 2 letters + 7 digits, or 1 letter + 8 digits | | Belgium | BE | 2 letters + 6 digits | | Bulgaria | BG | 9 digits | | Bolivia | BO | 6-9 alphanumerics | | Brazil | BR | 2 letters + 6 digits | | Bahamas | BS | 1-2 letters + 6-7 digits | | Belarus | BY | 2 letters + 7 digits | | Belize | BZ | 2 letters + 6 digits | | Canada | CA | pattern ^[A-Z]{2}\d{6}$\|^[A-Z]\d{6}[A-Z]{2}$ | | Switzerland | CH | pattern ^[A-Z][0-9A-Z]{7}$ | | Côte d'Ivoire | CI | 2 letters + 6 digits | | Chile | CL | pattern ^[A-Z]?\d{6,9}[0-9K]?$ | | Cameroon | CM | 9 alphanumerics | | China | CN | pattern ^(?:[GDSP]\d{8}\|[DSP]E\d{7}\|E[A-HJ-NP-Z0-9]\d{7})$ | | Colombia | CO | 8-9 alphanumerics | | Costa Rica | CR | 2 letters + 6 digits | | Cuba | CU | 1 letter + 6 digits | | Cyprus | CY | 1 letter + 6-8 digits | | Czech Republic | CZ | 8 digits | | Germany | DE | 9 alphanumeric characters (with MRZ checksum), or provisional A/B + 7 digits | | Denmark | DK | 9 digits | | Dominica | DM | 1-2 letters + 6-7 digits | | Dominican Republic | DO | 2 letters + 7 digits | | Algeria | DZ | 9 digits | | Ecuador | EC | 9 alphanumerics | | Estonia | EE | 1-2 letters + 7 digits | | Egypt | EG | 1 letter + 8 digits | | Spain | ES | pattern ^[A-Z0-9]{2}[A-Z0-9]?\d{6}$ | | Ethiopia | ET | pattern ^E[A-Z]?\d{6,7}$ | | Finland | FI | 2 letters + 7 digits | | Fiji | FJ | 6-7 digits | | Faroe Islands | FO | 9 digits | | France | FR | 2 digits + 2 letters + 5 digits | | United Kingdom | GB | 9 digits | | Grenada | GD | 1 letter + 6 digits | | Georgia | GE | 8 digits + optional letter or digit, or 2 digits + 2 letters + 5 digits | | Ghana | GH | 1 letter + 7 digits, or 2 letters + 6 digits | | Guinea | GN | 1 letter or digit + 8 digits | | Greece | GR | 2 letters + 7 digits | | Guatemala | GT | 9 digits | | Guyana | GY | 1 letter + 7 digits | | Hong Kong | HK | 1-2 letters + 6 digits + 1-2 alphanumerics | | Croatia | HR | 9 digits | | Haiti | HT | 2 letters + 6-7 digits, or 1 letter + 8 digits | | Hungary | HU | pattern ^[A-Z]{2}\d{6}$\|^[A-Z]{2}\d{7}$ | | Indonesia | ID | 1-2 letters + 6-7 digits | | Ireland | IE | 2 alphanumerics + 7 digits | | Israel | IL | 8 digits | | India | IN | 1 letter + 7 digits | | Iceland | IS | letter A + 7 digits | | Italy | IT | 2 alphanumerics + 7 digits | | Jamaica | JM | 1 letter + 7 digits | | Japan | JP | 2 letters + 7 digits | | Kenya | KE | 1-2 letters + 6-8 digits | | Cambodia | KH | 1 letter + 7-8 digits | | Saint Kitts and Nevis | KN | 1-2 letters + 6-7 digits | | South Korea | KR | pattern ^[MSROD]\d{8}$\|^[MSROD]\d{3}[A-Z]\d{4}$ | | Kazakhstan | KZ | 1 letter + 7-8 digits | | Laos | LA | 1 letter + 7 digits | | Lebanon | LB | pattern ^[A-Z]{2}\d{7}$\|^\d{6,7}$ | | Saint Lucia | LC | 1-2 letters + 6 digits | | Liechtenstein | LI | 1 letter + 5 digits | | Sri Lanka | LK | pattern ^(?:[A-Z]\d{7}\|[A-Z]{2}\d{6})$ | | Lithuania | LT | 8 alphanumerics | | Luxembourg | LU | 7-8 alphanumerics | | Latvia | LV | 2 alphanumerics + 7 digits | | Morocco | MA | 1-2 letters + 6-7 digits | | Monaco | MC | 2 letters + 6 digits | | Moldova | MD | 1-2 letters + 6-7 digits | | Montenegro | ME | 9 digits | | North Macedonia | MK | 1 letter + 7 digits | | Mongolia | MN | 2 letters + 7 digits | | Malta | MT | 7 digits | | Mauritius | MU | 1 letter + 7 digits | | Mexico | MX | 1 letter + 8 digits | | Malaysia | MY | 1 letter [AHK] + 8 digits | | Mozambique | MZ | 2 letters + 6-7 digits | | Nigeria | NG | 1 letter + 8 digits | | Netherlands | NL | 2 letters + 6 alphanumerics + 1 digit | | Norway | NO | 8 digits, or 1 letter + 7-8 alphanumerics | | Nepal | NP | 8 digits | | New Zealand | NZ | 2 letters + 6 digits | | Oman | OM | 1 letter + 7 digits | | Peru | PE | 9 digits | | Papua New Guinea | PG | 8 digits | | Philippines | PH | 1 letter + 6 digits, or 2 letters + 6 digits, or 2 letters + 7 digits, or 1 letter + 7 digits + 1 letter | | Pakistan | PK | 2 letters + 7 digits | | Poland | PL | 2 letters + 7 digits | | Portugal | PT | 1-2 letters + 6 digits | | Paraguay | PY | 6-9 alphanumerics | | Qatar | QA | 8 digits | | Romania | RO | pattern ^\d{8}$\|^\d{9}$ | | Serbia | RS | 9 digits | | Russian Federation | RU | 9 digits | | Solomon Islands | SB | 7 digits | | Sweden | SE | 8 digits, or 2 letters + 7 digits | | Singapore | SG | 1 letter [EK] + 7 digits + 1 letter | | Slovenia | SI | letter P + 1 letter + 7 digits | | Slovakia | SK | 1 letter + 7 digits, or 2 letters + 6-7 digits | | San Marino | SM | 6 digits | | Senegal | SN | 9 digits, or 1 letter + 8 digits | | Suriname | SR | 1 letter + 6-7 digits | | El Salvador | SV | 1 letter + 6-8 digits | | Thailand | TH | 2 letters + 7 digits | | Tajikistan | TJ | 9 digits | | Turkmenistan | TM | 2 letters + 7 digits | | Tunisia | TN | 1 letter + 6-7 digits | | Tonga | TO | 6 digits | | Turkey (Türkiye) | TR | 1 letter + 8 digits | | Trinidad and Tobago | TT | 2 letters + 6 digits | | Taiwan (Republic of China) | TW | 9 digits | | Tanzania | TZ | pattern ^[A-Z]\d{7}$\|^[A-Z]{2}\d{6}$ | | Ukraine | UA | pattern ^[A-Z]{2}\d{6}$\|^\d{8}$ | | Uganda | UG | pattern ^[A-Z]\d{7}$\|^[A-Z]{2}\d{6}$\|^[A-Z]\d{8}$ | | United States | US | pattern ^\d{9}$\|^[A-Z]\d{8}$ | | Uruguay | UY | 1-3 letters + 6 digits | | Saint Vincent and the Grenadines | VC | 2 letters + 8 digits | | Venezuela | VE | 8-9 digits | | Vietnam | VN | 1 letter + 7 digits, or 9 digits | | Samoa | WS | letter T + 6 digits | | Yemen | YE | 8 digits | | South Africa | ZA | 1 letter + 8 digits | | Zambia | ZM | 2 letters + 6 digits |

Note: Germany includes checksum validation for machine-readable passport formats. Additional checksum validation can be added for other countries as documentation becomes available.

Multiple Format Support: Some countries have transitioned to new passport formats while old formats remain valid during transition periods. The validators support both formats:

• United States: Old format (9 digits) and Next Generation format (1 letter + 8 digits)
• Canada: Old format (2 letters + 6 digits) and new format (1 letter + 6 digits + 2 letters)
• India: Old format (1 letter + 7 digits) and new ePassport format (2 letters + 6 digits)

Examples

TODO -- Usage examples

Credits

Thanks to python-stdnum for providing the inspiration and many of the checksum algorithm sources

References

https://www.oecd.org/tax/automatic-exchange/crs-implementation-and-assistance/tax-identification-numbers/ https://wiki.scn.sap.com/wiki/display/CRM/Country+Tax+Category+check

Release Notes

Releases are managed by release-please. PRs are squash-merged and the PR title becomes the commit on main, so it must be a Conventional Commit (fix(de/vat): ..., feat(br): ...); a CI check enforces it. fix bumps the patch version, feat the minor version, and ! or a BREAKING CHANGE: footer the major version.

Every push to main updates one release PR that bumps the version and prepends the CHANGELOG.md entry. Merging it tags the release, creates the GitHub release and publishes to npm with provenance (.github/workflows/release.yaml).