---
id: phonenumbers
version: "9.0.36"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# phonenumbers — Python version of Google's common library for parsing, formatting, storing and validating international phone numbers.

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install phonenumbers
uv add phonenumbers
poetry add phonenumbers

## Description

phonenumbers Python Library
===========================

[![Coverage Status](https://coveralls.io/repos/daviddrysdale/python-phonenumbers/badge.svg?branch=dev&service=github)](https://coveralls.io/github/daviddrysdale/python-phonenumbers?branch=dev)

This is a Python port of [Google's libphonenumber library](https://github.com/google/libphonenumber)
It supports Python 2.5-2.7 and Python 3.x (in the same codebase, with no
[2to3](http://docs.python.org/2/library/2to3.html) conversion needed).

Original Java code is Copyright (C) 2009-2015 The Libphonenumber Authors.

Release [HISTORY](https://github.com/daviddrysdale/python-phonenumbers/blob/dev/python/HISTORY.md),
derived from [upstream release notes](https://github.com/google/libphonenumber/blob/master/release_notes.txt).

[Documentation](https://daviddrysdale.github.io/python-phonenumbers/)

Installation
------------

Install using [pip](https://pypi.org/project/phonenumbers/) with:
```
pip install phonenumbers
```

Example Usage
-------------

The main object that the library deals with is a `PhoneNumber` object.  You can create this from a string
representing a phone number using the `parse` function, but you also need to...

## AI interpretation — verify before relying

Parses, validates, formats, and analyzes international phone numbers using Google's libphonenumber algorithm, with optional geocoding, carrier identification, and timezone lookup.

Verdict: A mature, dependency-free library for international phone number handling with strong maintenance signals, permissive licensing, and no known vulnerabilities. Suitable for production use in applications requiring phone number parsing, validation, or formatting.

[View on SkillFed](https://skillfed.io/packages/phonenumbers) · [View on PyPI](https://pypi.org/project/phonenumbers/)