Open developer data

Country phone number format dataset

Name: GetPhoneNum country phone format fixtures
Creator: GetPhoneNum
Published: 2026-07-19
License: https://github.com/qlv990304-boop/phone-number-generator/blob/main/packages/getphonenum-fixtures/LICENSE

Download calling codes, national patterns, E.164 examples, length notes and official-source links for the 31 countries currently supported by GetPhoneNum.

Download JSON Download CSV View JSON Schema

Fixture data, not subscriber data: a structural example may coincide with an assigned number unless its authority explicitly reserves it. Never call or text these values.

Cite or reuse the dataset

The dataset is available under the MIT license. When it supports documentation, research or an open-source project, link to this canonical page so readers can find the current version and official source notes.

GetPhoneNum country phone format fixtures, version 2026-07-20. https://getphonenum.com/phone-number-dataset

Source code, version history and corrections are available in the GitHub repository. Please report stale numbering rules through GitHub Issues with an official reference.

Validate the data contract

The public JSON Schema Draft 2020-12 contract defines required fields, ISO and E.164 patterns, value types and allowed record properties. Pin the dataset version in reproducible tests and validate updates before importing them.

npx ajv-cli validate -s country-phone-formats.schema.json -d country-phone-formats.json

Dataset fields

Field	Meaning
`iso2`	ISO 3166-1 alpha-2 country code used by the tools.
`callingCode`	International E.164 country calling code.
`nationalPattern`	Human-readable national presentation pattern.
`e164Example`	Canonical test fixture used in examples.
`fixtureSafety`	Whether the example is reserved or only structurally plausible.
`sourceUrl`	Official numbering authority or international reference.

Use in tests

Load the JSON into fixture factories or import the CSV into QA tools. Pin the version when reproducibility matters.

Check updates

National plans change. Follow each record's source URL and use a maintained numbering library for production validation.

Contribute a correction

Found a stale pattern or source? Use the contact link in the About page and include the official reference.