---
id: vonage-numbers
version: "1.0.5"
license: unclear
license_treatment: permissive
maintenance: active
---

# vonage-numbers — Vonage Numbers package

License: permissive · Maintenance: active · Downloads: 335.5K/mo

## What it is and what it does

vonage-numbers is a Python client library for Vonage's Numbers API, enabling programmatic management of phone numbers. It wraps HTTP calls to list owned numbers, search for available numbers, buy new numbers, cancel existing ones, and update number configurations such as SMS and voice callbacks. The package is designed as a component of the larger vonage SDK but can be used directly with appropriate credentials.

The package uses pydantic for request validation and vonage-http-client for transport, keeping dependencies minimal and focused. It supports filtering and pagination for number searches and list operations, and returns structured data (number objects, counts, and pagination tokens) rather than raw JSON. It targets modern Python versions from 3.9 onward.

Use it for:

- List and audit phone numbers currently owned by your Vonage account.
- Search for available phone numbers in specific countries and patterns before purchase.
- Programmatically buy phone numbers for your application without manual portal access.
- Configure SMS and voice callbacks on existing numbers to route inbound traffic.
- Cancel numbers no longer needed to manage inventory and reduce costs.
- Automate number provisioning workflows in larger telecom or contact-center applications.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides Python bindings to Vonage's Numbers API for managing, searching, buying, and updating phone numbers.

Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and uses a permissive license. Install it if you need to manage Vonage phone numbers programmatically. Verify first whether you can use it standalone or must pair it with the main vonage package, and confirm your Vonage account has API access enabled.

## Install

pip install vonage-numbers
uv add vonage-numbers
poetry add vonage-numbers

## Installing vonage-numbers

Before you install: Low install friction with a pure-Python wheel. Actively maintained as of July 2026 with 213 repository stars. Depends on vonage-http-client, vonage-utils, and pydantic—all standard, well-established packages.

License in practice: Licensed under Apache 2.0 (permissive). No restrictions on commercial or private use; you may modify and distribute freely with license attribution.

Quickstart:

pip install vonage-numbers

from vonage_numbers import ListOwnedNumbersFilter

numbers, count, next_page = vonage_client.numbers.list_owned_numbers(
    ListOwnedNumbersFilter(country='GB', size=3)
)

Requires an active Vonage account and a vonage_client instance (typically from the main vonage package). Requires Python 3.9 or later.

Verify before relying:

- Whether this package can be used standalone or requires the main vonage package to instantiate a client.
- API rate limits and quota constraints for number search and purchase operations.
- Whether number purchase operations incur charges and what the billing model is.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 335.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

vonage numbers api python, phone number management api, buy phone numbers programmatically, vonage sdk numbers, telecom number provisioning, search available phone numbers, number inventory management, telecom-api, vonage-sdk

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