# phonenumbers

Python library for parsing, formatting, storing and validating international phone numbers, a port of Google's libphonenumber.


Source: https://findsoftware.frbit.cloud/phonenumbers-py/
Last reviewed: 2026-11-16
Listed since: 2026-11-16

## Record

### Links

- repository: https://github.com/daviddrysdale/python-phonenumbers
- docs: https://daviddrysdale.github.io/python-phonenumbers/

### Identity

- status: active
- maintainer: David Drysdale
- maintainerType: individual
- parent: unknown
- firstRelease: 2011
- hqCountry: unknown

### Kind

- category: library
- hosting: python
- language: python
- runtime: python
- runtimeMin: python 2.5
- basedOn: unknown

### Content

- contentStore: not applicable
- databases: not applicable
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: not applicable

### Rendering and deploy

- runsAs: not applicable
- renderingModes: not applicable
- installMethod: pip

### License

- licenseModel: open-source
- license: Apache-2.0

### Releases

- currentMajor: 9
- latestReleaseDate: 2026-11-06

### Adoption

- githubStargazers: 3781
- packagistDownloads: not applicable
- npmWeeklyDownloads: not applicable
- contributors: 31
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 6592
- dependentPackages: 222

### Sources

- urls: https://api.github.com/repos/daviddrysdale/python-phonenumbers (read 2026-11-16)
- urls: https://github.com/daviddrysdale/python-phonenumbers/blob/dev/README.md (read 2026-11-16)
- maintainer: https://github.com/daviddrysdale/python-phonenumbers/blob/v9.0.43/python/pyproject.toml (read 2026-11-16)
- firstRelease: https://pypi.org/pypi/phonenumbers/json (read 2026-11-16)
- category: https://pypi.org/pypi/phonenumbers/json (read 2026-11-16)
- language: https://api.github.com/repos/daviddrysdale/python-phonenumbers (read 2026-11-16)
- runtime: https://github.com/daviddrysdale/python-phonenumbers/blob/dev/README.md (read 2026-11-16)
- runtimeMin: https://github.com/daviddrysdale/python-phonenumbers/blob/v9.0.43/python/pyproject.toml (read 2026-11-16)
- installMethod: https://github.com/daviddrysdale/python-phonenumbers/blob/dev/README.md (read 2026-11-16)
- license: https://github.com/daviddrysdale/python-phonenumbers/blob/v9.0.43/python/pyproject.toml (read 2026-11-16)
- currentMajor: https://api.github.com/repos/daviddrysdale/python-phonenumbers/tags?per_page=100 (read 2026-11-16)
- latestReleaseDate: https://pypi.org/pypi/phonenumbers/json (read 2026-11-16)
- githubStargazers: https://api.github.com/repos/daviddrysdale/python-phonenumbers (read 2026-11-16)
- contributors: https://api.github.com/repos/daviddrysdale/python-phonenumbers/contributors?per_page=1 (read 2026-11-16)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/pypi.org/packages/phonenumbers (read 2026-11-16)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/pypi.org/packages/phonenumbers (read 2026-11-16)

## Notes

phonenumbers is a Python library that parses phone numbers, formats them in national, international and E.164 layouts, and checks whether a number is possible or valid. It also formats a number as a user types it, and finds phone numbers inside a longer block of text. The package is a Python port of Google's libphonenumber, and the metadata that drives parsing ships with it.

The normal metadata loads one region at a time, on first use. Geocoding, carrier and timezone lookups need metadata held in separate packages that the caller imports explicitly. The repository also ships phonenumberslite, a package without those three lookups, for installs that run short of space or memory. The [documentation](https://daviddrysdale.github.io/python-phonenumbers/) describes the API.

## Worth knowing

A number written without a plus sign needs a default region, and parse raises an exception when it has neither. Static type checking works through the type stub files the package includes.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0
