Reference dataset for building international phone-number input validators and formatters. Each row provides the country, ISO alpha-2 code, the country dialing code (with +), a formatting pattern (mask using X for digits), a real example, and the typical national number length(s). Complements our existing Country Phone Codes list with the actual format layer applications need to validate and display numbers properly.
Pro tip: The North American Numbering Plan (+1) covers the US, Canada, and 24 Caribbean and US-territory countries that all share the same 10-digit format. Country code does not equal country — you have to look at the area code prefix to disambiguate.
Select which columns to include in your download.
About the Phone Number Formats Dataset
Every country uses its own combination of national prefix, area-code length, and grouping conventions for displaying phone numbers. The ITU-T E.164 standard sets a 15-digit international maximum, but local conventions vary wildly. Phone-number-validating libraries like Googles libphonenumber implement these rules in code; this dataset is the human-readable summary theyre built on.
Common Use Cases
International phone-input components in web and mobile apps, contact-form validators, CRM data-cleaning pipelines, SMS-sending platforms that need to format numbers per country, telephony cost estimators, and call-routing engines.
Column Reference
- country — country name in English.
- iso2 — ISO 3166-1 alpha-2 code.
- country_code — international dialing prefix with leading + (e.g. +1, +44, +33).
- format — formatting mask using X as a digit placeholder.
- example — a realistic example phone number.
- national_length — typical national number length (range when variable).
Shared Country Codes
Some country codes are shared: +1 (NANP — US, Canada, Caribbean), +7 (Russia, Kazakhstan), +44 (UK, Channel Islands, Isle of Man), +212 (Morocco, Western Sahara), +262 (Réunion, Mayotte, Comoros). Disambiguating requires looking at the first 1-3 digits of the national number. Libraries like libphonenumber handle this; the format column in this dataset is a starting point, not a complete parser.
National vs International Format
Most countries have a "national" presentation format (with a leading 0 trunk prefix in many cases) and an "international" format (with + and country code, no trunk prefix). This dataset uses the international format consistently — thats what cross-border applications should store. Convert to national format for display only where users expect it.
