vonage-numbers

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 on this page — 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

vonage-numbers on PyPI

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

Evidence: vonage_numbers-1.0.5-py3-none-any.whl

Tags

More Internet packages