Brand Reputation API Endpoints

Complete endpoint reference for trust and spam detection API

Choose Your API Version

v2 API RECOMMENDED

Reputation scoring (0-100), trust levels, enhanced response
v1 API

Basic spam/robocall detection, legacy support

Version Comparison

Feature v1 v2
Spam Detection ✓ ✓
Robocall Detection ✓ ✓
Scam Detection ✓ ✓
Reputation Score (0-100) — ✓
Trust Level (high/medium/low) — ✓
Last Updated Timestamp — ✓
Endpoint /api/v1/trust /api/v2/trust

Trust API v2 RECOMMENDED

Enhanced reputation scoring with trust levels. Use this version for new integrations.

POST /api/v2/trust

Get phone number reputation with scoring (0-100) and categorical trust levels.

Request

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

Request Body

Field Type Required Description
phone_number string Yes E.164 format (e.g., 12525551212)

Response

{
  "data": {
    "number": "12525551212",
    "is_spam": false,
    "is_robocall": false,
    "is_scam": false,
    "spam_type": "NONE",
    "complaint_count": 0,
    "subjects": [],
    "reputation_score": 85,
    "trust_level": "high",
    "last_updated": "2026-01-18T10:30:00Z"
  },
  "errors": []
}

Response Fields (v2 Exclusive)

Field Type Description
reputation_score integer Score from 0-100 (higher = more trustworthy)
trust_level string high (≥70), medium (40-69), low (<40)
last_updated string ISO 8601 timestamp of when data was last updated

Trust Level Thresholds

HIGH
Score ≥ 70
Trustworthy number
MEDIUM
Score 40-69
Use caution
LOW
Score < 40
Likely spam/fraud

Trust API v1 LEGACY

Basic spam and robocall detection. Still supported but consider upgrading to v2 for enhanced features.

POST /api/v1/trust

Get basic phone number trust information without scoring.

Request

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

Response

{
  "data": {
    "number": "12525551212",
    "is_spam": false,
    "is_robocall": false,
    "is_scam": false,
    "spam_type": "NONE",
    "complaint_count": 0,
    "subjects": [],
    "first_reported": null,
    "last_reported": null,
    "details": ""
  },
  "errors": []
}

GraphQL Endpoint

POST /graphql

Query trust information using GraphQL

Query

query TrustLookup($phoneNumber: String!) {
  trustLookup(phoneNumber: $phoneNumber) {
    phoneNumber
    isSpam
    isRobocall
    isScam
    spamType
    reputationScore
    trustLevel
    lastUpdated
  }
}

Variables

{
  "phoneNumber": "15555550123"
}