---
id: vonage-network-sim-swap
version: "1.1.2"
license: unclear
license_treatment: permissive
maintenance: active
---

# vonage-network-sim-swap — Package for working with the Vonage Sim Swap Network API.

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

## What it is and what it does

This package provides a Python client for the Vonage Sim Swap Network API, allowing you to query whether a SIM card associated with a phone number has been swapped and to retrieve the date of the last swap. It wraps HTTP calls to Vonage's network infrastructure via vonage-http-client and vonage-network-auth, with data validation through pydantic.

The package is designed primarily as a component of the larger vonage SDK but can be used independently. It requires prior registration and approval with Vonage's Network Registry for the specific networks and regions you intend to query. Once set up, you instantiate a client and call methods like check() to detect swaps or get_last_swap_date to retrieve timing information.

Use it for:

- Detect SIM swaps as part of account takeover prevention in authentication flows
- Verify phone number ownership by checking recent SIM swap history during account recovery
- Monitor for fraudulent SIM swaps on high-value accounts in financial or identity services
- Investigate suspicious account access by correlating login events with SIM swap dates
- Build compliance checks for telecom or payment platforms requiring SIM swap verification

## Worth the install?

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

Vonage Network Sim Swap API client that checks whether a SIM card has been swapped and retrieves the last swap date for a phone number.

Yes, if you are building fraud detection or account security features and have completed Vonage Network Registry registration. The package is actively maintained, has no known vulnerabilities, and integrates cleanly into the Vonage SDK ecosystem. Install only if you have a specific need for SIM swap detection and the required Vonage business relationship in place.

## Install

pip install vonage-network-sim-swap
uv add vonage-network-sim-swap
poetry add vonage-network-sim-swap

## Installing vonage-network-sim-swap

Before you install: Low install friction with a pure Python wheel. Active maintenance with recent commits and no known vulnerabilities. Designed as part of the Vonage SDK ecosystem but usable independently.

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

Quickstart:

pip install vonage-network-sim-swap

from vonage_network_sim_swap import SwapStatus
swap_status: SwapStatus = vonage_client.sim_swap.check(phone_number='MY_NUMBER')
print(swap_status.swapped)

Requires prior registration with Vonage Network Registry and approval for your target networks and regions; vonage_client instance must be pre-configured with valid credentials.

Verify before relying:

- Whether this package can be used standalone or requires the broader vonage SDK for authentication setup
- What credentials or API keys are needed beyond Vonage Network Registry registration
- Rate limits or usage quotas imposed by the Vonage API backend

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

SIM swap detection, SIM card swap check, phone number SIM swap API, Vonage network API client, mobile SIM swap verification, last SIM swap date, SIM swap status check, fraud-detection, telecom-api, security

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