Know everything about a phone number before you dial
Real-time carrier lookup, line-type detection, active status checks, and spam scoring — all through a single API call.
Key benefits
Real-time carrier lookup
Instantly identify the carrier serving any phone number worldwide, including MCC and MNC codes for mobile numbers.
Line-type detection
Determine whether a number is mobile, landline, VoIP, or toll-free before routing calls or sending SMS.
Spam score (0–100)
Score every number on a 0–100 spam risk scale based on reported abuse patterns, fraud signals, and carrier data.
Active status check
Verify whether a number is currently active and reachable before committing to a call or message.
Batch lookups
Enrich up to 1,000 numbers in a single API request. Ideal for CRM cleansing, lead validation, and fraud screening.
CNAM caller ID
Retrieve the registered caller name (CNAM) for US numbers to display friendly caller IDs on inbound calls.
How it works
Send a phone number
POST any E.164-formatted phone number to the Lookups API. Specify which data fields you need to keep costs low.
Receive enriched data
Get carrier details, line type, active status, spam score, porting history, and CNAM back in milliseconds.
Make smart routing decisions
Block high-risk numbers, route by line type, personalise messages by carrier, or skip unreachable numbers entirely.
Code example
from cloudvno import Client
client = Client("YOUR_API_KEY")
# Look up a phone number
lookup = client.lookups.phone_number("+12125559876")
print(f"Carrier: {lookup.carrier.name}")
print(f"Line type: {lookup.line_type}") # mobile, landline, voip
print(f"Active: {lookup.active}")
print(f"Spam score: {lookup.spam_score}") # 0-100
print(f"Ported: {lookup.ported}")Features
Pricing
See full pricing →Pay as you go. No minimums. No contracts. Volume discounts available.
Get started in 5 minutes
Sign up free and start building with CloudVNO. No credit card required.