---
id: vonage-voice
version: "1.5.1"
license: unclear
license_treatment: permissive
maintenance: active
---

# vonage-voice — Vonage voice package

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

## What it is and what it does

vonage-voice is a Python client library for Vonage's Voice API, enabling programmatic control of phone calls. It wraps Vonage's REST endpoints and provides a Pydantic-based request/response model layer, so you construct call parameters as typed objects rather than raw dictionaries. The package includes an NCCO builder—a set of classes representing call control actions (Talk, Play, Transfer, etc.)—that you chain together to define call flow logic.

You use it by instantiating a Vonage client (typically through the main vonage package) and calling methods like create_call, transfer_call_ncco, play_audio_into_call, or hangup on the voice submodule. The package handles serialization to Vonage's API format and parsing responses back into Python objects. It depends on vonage-http-client for HTTP transport, vonage-utils for shared utilities, and pydantic for data validation.

Use it for:

- Build an IVR (interactive voice response) system that plays prompts and routes calls based on DTMF input.
- Programmatically initiate outbound calls with custom audio or text-to-speech messages for notifications or surveys.
- Transfer an active call to a new NCCO or URL without dropping the connection.
- Play audio streams or TTS into an ongoing call for real-time announcements or hold messages.
- Query call history and status across your Vonage account with filtering by date, status, or conversation ID.

## Worth the install?

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

Provides Python bindings to Vonage's Voice API for making and managing phone calls, including call creation, transfer, audio/TTS playback, and NCCO (Call Control Object) building.

Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and is the official Vonage Voice API client for Python. Install it if you need to integrate Vonage voice capabilities into a Python application; the Pydantic-based API and NCCO builder reduce boilerplate compared to raw HTTP calls.

## Install

pip install vonage-voice
uv add vonage-voice
poetry add vonage-voice

## Installing vonage-voice

Before you install: Low install friction with a pure-Python wheel and three lightweight runtime dependencies. Active maintenance with a recent release (25 days old) and ongoing repository activity.

License in practice: Permissive Apache license allows commercial and private use with minimal restrictions.

Quickstart:

pip install vonage-voice

from vonage import Vonage, Auth
from vonage_voice import CreateCallRequest, Talk

vonage_client = Vonage(Auth('MY_AUTH_INFO'))
ncco = [Talk(text='Hello world', loop=3, language='en-GB')]
call = CreateCallRequest(
    to=[{'type': 'phone', 'number': '1234567890'}],
    ncco=ncco,
    random_from_number=True,
)
response = vonage_client.voice.create_call(call)

Requires Vonage authentication credentials and an active Vonage account.

Verify before relying:

- Whether vonage-http-client and vonage-utils are maintained and have their own security track record.
- Specific latency or throughput characteristics for high-volume call operations.
- Whether the package supports webhook handling for inbound calls or only outbound call control.

## Package facts

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

## Tags

vonage voice api python, make phone calls programmatically, call control and management, ncco call builder, vonage sdk voice, telephony api client, call transfer and routing, telephony, vonage-sdk, call-control

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