vonage-http-client

What it is and what it does

vonage-http-client is a synchronous HTTP client library designed to handle authenticated requests to Vonage APIs. It wraps the requests library and manages authentication transparently, supporting both basic (API key/secret) and JWT authentication methods. The package is primarily used internally by the vonage Python SDK, though it can be installed and used independently.

The client is initialized with an Auth instance for credentials and optional HttpClientOptions to configure API hosts, timeouts, connection pooling, and retry behavior. It exposes methods for GET and POST requests, caches the last request and response for debugging, and allows customization of the User-Agent header. Error handling is provided through dedicated exception classes like HttpRequestError.

Use it for:

• Building custom integrations with Vonage APIs when you need lower-level control than the main SDK provides
• Debugging or inspecting raw HTTP requests and responses sent to Vonage endpoints via last_request and last_response properties
• Configuring connection pooling, timeouts, and retry behavior for high-volume or latency-sensitive Vonage API calls
• Switching between JWT and basic authentication on a per-request basis for multi-tenant or credential-rotation scenarios
• Extending or wrapping the HTTP layer in applications that already depend on vonage-http-client indirectly through the SDK

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides a synchronous HTTP client for authenticated requests to Vonage APIs, handling both API key/secret and JWT authentication methods.

Yes, if you are using the vonage SDK or need direct control over HTTP requests to Vonage APIs. The package is actively maintained, has low install friction, and carries a permissive license. Install it only if you have a specific reason to use it independently; most users should rely on the higher-level vonage SDK instead.

Install

vonage-http-client on PyPI

pip install vonage-http-client

uv add vonage-http-client

poetry add vonage-http-client

Installing vonage-http-client

Before you install

Low friction install with five straightforward dependencies (vonage-utils, vonage-jwt, requests, typing-extensions, pydantic). Active maintenance with last commit 2026-07-20 and 213 repository stars. Supports Python 3.9 through 3.13.

License in practice

Licensed under Apache Software License (permissive), allowing commercial and private use with minimal restrictions.

Quickstart

pip install vonage-http-client

from vonage_http_client import HttpClient, HttpClientOptions
from vonage_http_client.auth import Auth

auth = Auth(api_key='your_api_key', api_secret='your_api_secret')
options = HttpClientOptions(api_host='api.nexmo.com', timeout=30)
client = HttpClient(auth=auth, http_client_options=options)
response = client.get(host='api.nexmo.com', request_path='/v1/messages')

Requires Python 3.9 or later and valid Vonage API credentials (API key and secret, or JWT configuration).

Verify before relying

• Whether this package is recommended for direct use or primarily intended as an internal dependency of the vonage SDK
• Performance characteristics under high concurrency or large request volumes
• Specific retry and timeout behavior in edge cases beyond the documented options

Package facts

Evidence: vonage_http_client-1.5.2-py3-none-any.whl

Tags

More WWW/HTTP packages