Trust & Reputation API – U.S. Phone Number Compliance

Spam & Fraud Detection

The Brand Reputation API provides comprehensive trust and reputation information for phone numbers. It identifies spam, robocalls, and scam numbers using our master spam database as the source of truth.

Reputation Scoring

Our advanced reputation scoring system analyzes multiple data sources to provide accurate trust assessments:

• FTC Complaint Database: Access to federal complaint records
• Spam & Robocall Reports: Aggregated reports from reputation and analytics sources
• Consumer Reports: Crowdsourced spam and scam reports
• Machine Learning: Pattern recognition for emerging threats

Note on coverage: the score is a single aggregated reputation signal. It is not a per-carrier label and does not represent a number's live status on any one carrier's network (AT&T, Verizon and T-Mobile each apply their own proprietary spam analytics). A NONE / clean result means the number is not flagged in our aggregated data — a strong signal for triage, not a per-carrier certification.

Authentication

All API requests require authentication using your API key. Include your API key in the request headers:

Authorization: Bearer YOUR_API_KEY

Don't have an API key? Get your API key here.

API Methods

{
  "phone_number": "19494600638"
}

{
  "data": {
    "number": "19494600638",
    "is_spam": true,
    "is_robocall": true,
    "is_scam": false,
    "spam_type": "ROBOCALL",
    "complaint_count": 2,
    "subjects": ["Warranties"],
    "first_reported": "2022-06-27T12:33:40Z",
    "last_reported": "2025-07-04T18:02:13Z",
    "details": "FTC DNC complaints: 2"
  },
  "errors": []
}

API v2 - Enhanced Reputation Scoring

The Trust API v2 adds quantitative reputation scoring for more precise trust assessments. In addition to the boolean spam flags, v2 returns a numeric reputation score and categorical trust level.

{
  "phone_number": "19494600638"
}

{
  "data": {
    "number": "19494600638",
    "is_spam": true,
    "is_robocall": true,
    "is_scam": false,
    "spam_type": "ROBOCALL",
    "complaint_count": 2,
    "subjects": ["Warranties"],
    "reputation_score": 20,
    "trust_level": "low",
    "last_updated": "2026-01-18T12:30:00Z"
  },
  "errors": []
}

v1 vs v2 Comparison

Parameters

Response Format

Success Response

{
  "data": {
    "number": "19494600638",
    "is_spam": true,
    "is_robocall": true,
    "is_scam": false,
    "spam_type": "ROBOCALL",
    "complaint_count": 2,
    "subjects": ["Warranties"],
    "first_reported": "2022-06-27T12:33:40Z",
    "last_reported": "2025-07-04T18:02:13Z",
    "details": "FTC DNC complaints: 2"
  },
  "errors": []
}

Response Fields

Additional v2 Response Fields

Spam Types

The spam_type field uses priority ordering: ROBOCALL > SCAM > SPAM

• NONE - No spam detected
• SPAM - Known spam number
• ROBOCALL - Automated calling system (highest priority)
• SCAM - Fraudulent caller

FTC/Traceback Integration

Seamlessly integrate with FTC traceback reporting and compliance systems:

• Automated Compliance: Real-time FTC data integration
• Traceback Reports: Access to official traceback investigations
• Regulatory Updates: Stay current with federal enforcement actions
• Audit Trail: Complete documentation for compliance reporting

Sample Requests

cURL - REST API

curl -X POST https://verirouteintel.com/api/v1/trust \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone_number": "19494600638"}'

Python - REST API

import requests

url = "https://verirouteintel.com/api/v1/trust"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "phone_number": "19494600638"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(f"Spam Status: {result['data']['spam_type']}")

cURL - REST API v2 (with Reputation Score)

curl -X POST https://verirouteintel.com/api/v2/trust \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone_number": "19494600638"}'

Python - REST API v2

import requests

url = "https://verirouteintel.com/api/v2/trust"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
data = {
    "phone_number": "19494600638"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()

# Access reputation score and trust level
data = result['data']
print(f"Reputation Score: {data['reputation_score']}/100")
print(f"Trust Level: {data['trust_level']}")
print(f"Last Updated: {data['last_updated']}")

Error Handling

The API returns standard HTTP status codes and detailed error messages:

{
  "data": {
    "number": "",
    "is_spam": false,
    "spam_type": "INVALID_NUMBER"
  },
  "errors": ["Invalid phone number format"]
}

Rate Limits

API requests are limited to:

• 200 rps
• 200 rps per minute
• Rate limits are per API key
• Upgrade your plan for higher limits

Rate limit headers are included in all responses:

X-RateLimit-Limit: 200
X-RateLimit-Remaining: 199
X-RateLimit-Reset: 60

429 Too Many Requests

When rate limits are exceeded, the API returns a 429 status code:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please wait before making another request.",
  "retry_after": 60
}

FAQs