# Country Calling Codes and Telephone Number Lengths

Territory calling codes, dialing-prefix metadata and number-length ranges by service type.

## Contents

| File | Records | Format |
|---|---:|---|
| calling-codes.json | 254 | JSON array |
| number-lengths.json | 1,177 | JSON array |

The download contains the populated data, a field dictionary, source metadata, reuse terms, a change log and file digests. It contains no scripts, libraries, executables or conversion tools.

## Coverage

Every territory/service record and every explicit possibleLengths entry in the source metadata. Source national-number validation patterns and formatting logic are deliberately absent. No phone-number conversion or validation code is included. Shared calling codes are retained as separate territory records.

## Sources and dates

- [Google libphonenumber contributors](https://raw.githubusercontent.com/google/libphonenumber/master/resources/PhoneNumberMetadata.xml): retrieved metadata snapshot. Retrieved 2026-09-08T02:02:47.568375+00:00.

## Read the data

JSON tables are arrays of records. GeoJSON files are FeatureCollections, with data fields under each feature’s properties. `data-dictionary.json` defines the fields, units, nulls and observed types. `metadata.json` supplies primary keys and source hashes. Preserve identifiers as text and distinguish missing values from zero.

## Example record

This is an actual record from the data. For map layers, the example shows properties; the downloaded GeoJSON also contains the complete geometry.

```json
{
  "record_id": "AC:247",
  "territory_code": "AC",
  "calling_code": "247",
  "main_country_for_shared_code": false,
  "international_prefix_pattern": "00",
  "national_prefix": null,
  "preferred_international_prefix": null
}
```

## Reuse terms

Apache-2.0. Copyright The Libphonenumber Authors. Selected metadata fields normalized by Arcomm on 2026-09-08.

[Publisher terms](https://github.com/google/libphonenumber/blob/master/LICENSE). License notices are included where supplied.

## Tracking changes

Compare record_id, calling codes, prefixes and per-type lengths as upstream metadata changes.

This publication is a snapshot. No automatic refresh is scheduled. New imports must preserve their source version, retrieval date and hashes, then publish a new Arcomm revision.

## Download

[Download the file](/files/2f3171e5d260b4b56bf62b87cd7fec9730cb7c08a7bedfbdaf798eb68998a704)

SHA-256: `2f3171e5d260b4b56bf62b87cd7fec9730cb7c08a7bedfbdaf798eb68998a704`

Size: 22820 bytes.

## Revisions

[Revision history](/agent/docs/telephone-numbering-reference/history)