vonage-identity-insights

What it is and what it does

vonage-identity-insights is a Python client library for the Vonage Identity Insights API, which provides real-time lookups of carrier, subscriber, and device information tied to phone numbers. It wraps the HTTP API calls and provides typed request/response objects built on pydantic for validation and serialization. The package is designed to integrate with the main vonage SDK but can be used independently to query phone number attributes for fraud detection, identity verification, and subscriber intelligence.

The library depends on vonage-http-client for HTTP communication, vonage-utils for shared utilities, and pydantic for data validation. It supports Python 3.9 through 3.13 and is actively maintained. The API requires a Vonage account and authentication to function; typical use involves constructing an IdentityInsightsRequest with a phone number and desired insight types (such as SIM swap detection), then calling the requests method to retrieve the response.

Use it for:

• Detect SIM swap fraud by querying whether a phone number has recently changed carriers or devices.
• Verify subscriber identity during account creation or login by retrieving carrier and device attributes.
• Build fraud prevention rules that flag suspicious phone number activity or mismatches with user profiles.
• Enrich customer data with carrier and device information for segmentation or risk scoring.
• Validate phone numbers in real time before sending SMS or voice communications.

Worth the install?

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

Provides Python access to the Vonage Identity Insights API to retrieve real-time carrier, subscriber, and device attributes for phone numbers.

Yes, if you need real-time phone number intelligence for fraud detection or identity verification and already use or plan to use the Vonage platform. The package is actively maintained, has low install friction, and integrates cleanly with the Vonage SDK ecosystem. No security vulnerabilities are known. The main constraint is the requirement for a Vonage account and API credentials.

Install

vonage-identity-insights on PyPI

pip install vonage-identity-insights

uv add vonage-identity-insights

poetry add vonage-identity-insights

Installing vonage-identity-insights

Before you install

Low install friction with a pure-Python wheel distribution. Active maintenance with recent commits and a permissive Apache license. Depends on vonage-http-client, vonage-utils, and pydantic—all standard Vonage SDK components.

License in practice

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

Quickstart

pip install vonage-identity-insights

from vonage import Vonage, Auth
from vonage_identity_insights import IdentityInsightsRequest, InsightsRequest, SimSwapInsight

client = Vonage(auth=auth)
request = IdentityInsightsRequest(
    phone_number="1234567890",
    purpose="FraudPreventionAndDetection",
    insights=InsightsRequest(sim_swap=SimSwapInsight(period=240))
)
response = client.identity_insights.requests(request)

Requires a Vonage account and valid authentication credentials to make API requests.

Verify before relying

• Whether the package works standalone or requires the main vonage package to be installed
• Rate limits or quota constraints for the Identity Insights API
• Supported phone number formats and geographic coverage

Package facts

Evidence: vonage_identity_insights-1.0.0-py3-none-any.whl

Tags

More Internet packages