---
id: vonage-account
version: "1.1.2"
license: unclear
license_treatment: permissive
maintenance: active
---

# vonage-account — Vonage Account API package

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

## What it is and what it does

vonage-account is a Python package that wraps Vonage's Account API, providing methods to query and manage account state. It handles account balance retrieval, credit top-ups, service pricing lookups across countries or dialing prefixes, secret lifecycle management (create, list, revoke), and webhook configuration for SMS callbacks. The package uses Pydantic for response validation and is built on vonage-http-client and vonage-utils for HTTP communication and utilities.

The package is designed as a component of the larger vonage SDK but can be imported directly. It abstracts away HTTP details and provides typed request/response objects, making it straightforward to integrate account management into applications that bill through Vonage or need to monitor account state programmatically.

Use it for:

- Check account balance and trigger top-ups when balance falls below a threshold
- Retrieve SMS pricing for specific countries to calculate per-message costs dynamically
- Manage account secrets (API credentials) programmatically for security rotation
- Configure SMS inbound and delivery receipt webhooks without manual dashboard access
- Query pricing by dialing prefix to support international routing decisions

## Worth the install?

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

Provides Python bindings for Vonage's Account API, enabling account balance queries, top-ups, pricing lookups, secret management, and webhook configuration.

Yes, if you use Vonage's services and need programmatic account management. Low friction, actively maintained, no vulnerabilities, and permissive license. The package is well-integrated into the Vonage SDK ecosystem and handles common account operations cleanly. Install only if you actually need these account-level features; it is not a general-purpose utility.

## Install

pip install vonage-account
uv add vonage-account
poetry add vonage-account

## Installing vonage-account

Before you install: Low install friction with a pure Python wheel. Active maintenance with recent commits and no known vulnerabilities. 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-account

from vonage_account import GetCountryPricingRequest

# Assuming vonage_client is a vonage.Vonage instance
response = vonage_client.account.get_country_pricing(
    GetCountryPricingRequest(type='sms', country_code='US')
)

Intended for use as part of the main vonage package; requires a vonage.Vonage client instance to function.

Verify before relying:

- Whether this package can be used independently or only through the main vonage package
- Specific rate limits or quotas for Account API operations
- Whether all account operations require API key authentication

## Package facts

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

## Tags

vonage account api python, manage vonage account balance, vonage pricing lookup, vonage secret management, vonage sms webhook configuration, vonage account sdk, vonage api client, vonage-sdk, account-management, telecom-api

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