---
id: vonage-http-client
version: "1.5.2"
license: unclear
license_treatment: permissive
maintenance: active
---

# vonage-http-client — An HTTP client for making requests to Vonage APIs.

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

## 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 above — 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

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

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

## Tags

vonage api http client, authenticated http requests vonage, vonage sdk http layer, api key jwt authentication client, vonage rest api client, synchronous http client library, vonage api credentials management, http-client, vonage-api, authentication

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