---
id: vonage-identity-insights
version: "1.0.0"
license: unclear
license_treatment: permissive
maintenance: active
---

# vonage-identity-insights — Vonage Identity Insights package

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

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

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

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

## Tags

vonage identity insights api, phone number carrier lookup, sim swap detection, subscriber device attributes, vonage python sdk, phone number verification, carrier information api, phone-number-lookup, fraud-detection, vonage-sdk

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