ScamVerify™ API
Threat intelligence API for phone numbers, URLs, text messages, emails, documents, and QR codes. 6 verification channels powered by millions of FTC records, carrier data, vision AI, and government database verification.
The ScamVerify™ API gives you programmatic access to our threat intelligence platform. Verify phone numbers, URLs, text messages, emails, documents, and QR codes against millions of government records, carrier databases, and community reports, then get AI-synthesized risk assessments in plain English.
Data Sources
Every lookup is checked against multiple proprietary and government data sources:
- FTC Do Not Call Registry - 14M+ complaint records with subject, description, and violation data
- FCC Consumer Complaints - Federal consumer complaint filings
- Twilio Carrier Intelligence - Carrier name, line type (mobile, landline, VoIP), and CNAM data
- URLhaus - Malware URL database with real-time threat feeds
- ThreatFox - IOC (Indicators of Compromise) database with 54,000+ malicious domains
- IPQS (IP Quality Score) - Phone and URL reputation scoring
- Smarty US Street API - Address validation and CMRA (mailbox service) detection
- Google Places - Institution verification at claimed addresses
- CourtListener - Federal and state judge database, case law citation verification
- GovInfo - Federal statute and regulation verification (U.S. Code, CFR)
- GPT-4o Vision AI - Entity extraction from document images (addresses, officials, citations, amounts)
- Community Reports - User-submitted scam reports with moderation
Channels
Phone Lookup
Verify any US phone number. Returns carrier info, line type, FTC/FCC complaint history, robocall detection, and an AI-generated risk narrative.
URL Verification
Check any URL or domain against malware databases, phishing feeds, and community reports. Identifies malicious hosting, suspicious registrars, and known threat actors.
Text Analysis
Analyze SMS or text message content for scam indicators. Detects phishing links, urgency tactics, impersonation patterns, and social engineering signals.
Email Analysis
Analyze email headers and body content for phishing, spoofing, and fraud indicators. Extracts embedded URLs and phone numbers for cross-channel verification.
Document Analysis
Upload a photo of a suspicious document. Vision AI extracts entities (addresses, officials, citations) and verifies them against government databases. Detects fake court notices, toll scams, fraudulent invoices, and more.
QR Code Analysis
Upload a QR code image for server-side decoding and URL verification. Detects phishing QR codes on parking meters, restaurant menus, and packages. Non-URL QR content (phone, email, vCard) is decoded and returned without consuming quota.
QR Codes: Use the QR Code Analysis endpoint to upload a QR code image directly. The server decodes the QR code and runs the full URL verification pipeline automatically. Alternatively, decode locally and use the URL Verification endpoint. See the QR Code Scanner tutorial for a complete walkthrough.
Key Features
- AI-Powered Synthesis - Raw data from multiple sources is synthesized by AI into a clear risk score, verdict, and plain-English explanation
- Vision AI Document Scanning - GPT-4o extracts entities from document images, then verifies them against Smarty, Google Places, CourtListener, and GovInfo
- Sub-Second Cached Responses - Previously looked-up numbers, URLs, and documents return instantly from cache
- Per-Channel Quotas - Manage usage independently for each channel (phone, URL, text, email, document, QR)
- Batch Processing - Submit multiple phone numbers or URLs in a single request
- Test Mode - Validate your integration without consuming quota using
sv_test_keys
Quick Example
Look up a phone number with a single cURL command:
curl -X POST https://scamverify.ai/api/v1/phone/lookup \
-H "Authorization: Bearer sv_live_abc123..." \
-H "Content-Type: application/json" \
-d '{"phone_number": "+12025551234"}'The response includes a risk score, verdict, and detailed signals:
{
"risk_score": 82,
"verdict": "high_risk",
"explanation": "This number has 14 FTC complaints filed since 2024, primarily for robocalls claiming to be from the IRS. The carrier is a known high-risk VoIP provider.",
"signals": {
"ftc_complaints": 14,
"carrier": "Example VoIP Corp",
"line_type": "voip",
"robocall_detected": true
}
}