---
id: vonage-network-number-verification
version: "1.0.2"
license: unclear
license_treatment: permissive
maintenance: active
---

# vonage-network-number-verification — Package for working with the Vonage Number Verification Network API.

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

## What it is and what it does

vonage-network-number-verification is a client library for Vonage's Number Verification Network API, enabling verification of a mobile device's phone number by checking the SIM card linked to the device when it is connected to a mobile data network. The verification process is transparent to the end user and requires no manual input. The package handles OAuth2 authentication and provides methods to generate OIDC URLs for front-end authorization flows and to submit verification requests with authorization codes.

The package is designed primarily as a component within the larger Vonage SDK rather than for standalone use. It depends on vonage-http-client for HTTP communication, vonage-network-auth for authentication handling, vonage-utils for shared utilities, and pydantic for data validation. To use the API, you must first register a business profile with the Vonage Network Registry and obtain approval for each network and region where you want to deploy verification.

Use it for:

- Verify a user's phone number during account registration or login without requiring SMS or email confirmation codes.
- Confirm that a device is connected to its registered mobile network as part of a fraud prevention or identity verification workflow.
- Integrate transparent phone verification into a web or mobile application that requires proof of device ownership.
- Streamline KYC (Know Your Customer) processes by automatically verifying phone numbers linked to active SIM cards.
- Build a multi-factor authentication system that leverages network-based verification instead of out-of-band channels.

## Worth the install?

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

Verifies a mobile device's phone number by checking the SIM card linked to a device connected to a mobile data network, using OAuth2 authentication without requiring user input.

Yes, if you are building applications that require phone number verification and have registered with Vonage's Network Registry. The package is actively maintained, has low install friction, and integrates cleanly into the Vonage SDK ecosystem. No security vulnerabilities are known. Install it as part of your Vonage integration; standalone use is not recommended without understanding its role within the larger SDK.

## Install

pip install vonage-network-number-verification
uv add vonage-network-number-verification
poetry add vonage-network-number-verification

## Installing vonage-network-number-verification

Before you install: Low install friction with a pure Python wheel distribution. The package is actively maintained as of July 2026, with four lightweight runtime dependencies (vonage-http-client, vonage-network-auth, vonage-utils, pydantic). Designed as a component of the larger Vonage SDK rather than standalone use.

License in practice: Licensed under Apache License 2.0 (permissive), allowing commercial use, modification, and distribution with minimal restrictions. No notable licensing constraints for typical use.

Quickstart:

pip install vonage-network-number-verification

from vonage_network_number_verification import CreateOidcUrl, NumberVerificationRequest

url_options = CreateOidcUrl(
    redirect_uri='https://example.com/redirect',
    state='c9896ee6-4ff8-464c-b393-d56d6e638f88',
    login_hint='+990123456',
)
url = number_verification.get_oidc_url(url_options)

response = number_verification.verify(
    NumberVerificationRequest(
        code='code',
        redirect_uri='https://example.com/redirect',
        phone_number='+990123456',
    )
)
print(response.device_phone_number_verified)

Requires prior registration and approval with the Vonage Network Registry for each network and region you intend to use; user's device must be connected to their mobile network for verification to succeed.

Verify before relying:

- Whether this package can be used independently or requires the parent vonage SDK for full functionality.
- Details on which mobile networks and regions are currently supported.
- Rate limits or quota constraints for the Number Verification API.

## Package facts

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

## Tags

mobile number verification, phone number verification api, vonage network verification, sim card verification, device phone number verification, oauth2 phone verification, network-based number verification, phone-verification, oauth2, vonage-api

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