1. Verdicts
CallerAPI Documentation
  • Quickstart
  • Use cases
    • For carriers (MNOs/MVNOs)
    • CPaaS platforms
    • Cloud communications providers
    • SIP trunking providers
    • PBX/Cloud PBX
    • UCaaS vendors
  • Account
    • Balance and email
      GET
  • Spam protection
    • Voice firewall
      • Get started
      • Quickstart
        • What you get
        • Before you start
        • Test with a recording
        • Connect your switch
        • Switch notes
        • Twilio and Telnyx
        • Send text instead of audio
      • Verdicts
        • Read a verdict
        • What to do with a verdict
        • Block a caller
        • Events and webhooks
      • Honeypot
        • Hand a call over
        • Audio, events, and limits
      • Reference
        • Endpoints
        • Errors
        • Limits and thresholds
        • Production checklist
      • REST
        • What this deployment can do
        • List the verdict categories
        • List the honeypot personas
        • Score a transcript or a recording
        • List your recent sessions
        • Get one session with verdict and intel
        • Twilio voice URL for a screened number
        • Preview the Twilio TwiML
        • Telnyx voice URL for a screened number
        • Twilio voice URL for a honeypot number
        • Telnyx voice URL for a honeypot number
      • WebSocket
        • Live scam filter stream
        • Honeypot stream
    • Daily spam reports
      • Webhook
        • Subscribe to daily reports
        • Unsubscribe from daily reports
        • List webhook subscriptions
        • Manual dispatch of reports
        • Test webhook
      • REST
        • Fetch daily spam reports
    • 15 days spam CSV snapshot
      GET
    • Spam score + HLR
      GET
  • Mobile SDK
    • Get started
    • Quickstart
      • What you get
      • Get your keys
      • Android
      • iOS
      • Flutter
      • React Native
      • Check it works
    • Call screening
      • What each platform can do
      • Android call screening
      • iOS prerequisites
      • iOS add the extension
      • iOS test on device
    • Reference
      • Methods
      • Errors
      • Limits and billing
      • Troubleshooting
  • Data partners
    • Partner tems & docs
    • Upload spam reports
    • Upload contacts
  • Fraud prevention
    • Ported date
    • Porting history
    • Online presence
    • KYC user identity
  • Schemas
    • Spam protection
      • Spam score request
      • Business info
      • Carrier info
      • Complaint (without number)
      • Daily spam reports request
      • Complaint (with phone)
  1. Verdicts

Read a verdict

Every verdict and session.ended event, and every POST /scan response, carries one verdict object.
{
  "score": 0.94,
  "level": "scam",
  "category": "Advance Fee Loan",
  "tactics": ["callback_pressure", "untraceable_payment", "urgency"],
  "signals": ["pay us up front, and then we would give you the loan"],
  "summary": "Caller offers a $10,000 loan and demands an upfront payment within the hour.",
  "source": "combined"
}

Fields#

FieldMeaning
score0 to 1. Probability that the caller is a scammer.
levelBucket of the score. See below.
categoryOne exact CallerAPI complaint subject, or none.
tacticsManipulation techniques observed. Sorted, no duplicates.
signalsShort pieces of evidence. Above a score of 0.6 they quote the caller's words.
summaryTwo sentences at most. Present when a model produced the verdict.
sourceheuristic (rules only), llm (model only), combined (both), or stored (read back from the session record).

Levels#

LevelScore
cleanbelow 0.3
suspicious0.3 to 0.59
likely_scam0.6 to 0.84
scam0.85 and above
Act on level, not on score. The levels are stable. The score moves.

Categories#

category is one exact CallerAPI complaint subject. It is the same vocabulary as the complaints on Spam score + HLR and the spam reports feed, so your CDR, your lookup, and the feed agree.
Advance Fee Loan
Bank/Credit Card Company Imposter
Business Email Compromise
Calls pretending to be government, businesses, or family and friends
Charity
Computer & Technical Support
Counterfeit Product
COVID-19
Credit Cards
Credit Repair/Debt Relief
Cryptocurrency
Debt Collection
Lotteries, Prizes & Sweepstakes
Medical & Prescriptions
Moving
No Subject Provided
Phishing
Reducing Your Debt (Credit Cards, Mortgage, Student Loans)
Rental
Romance
Tax Collection
Travel/Vacation/Timeshare
Utility
Warranties & Protection Plans
Work From Home & Other Ways To Make Money
Yellow Pages/Directories
Hang Up
Scammers
Advertising
Surveys
Financial Services
Store
Company
Other
none means the call is clean. It is not a complaint subject and is never filed.
Two pairs are easy to confuse:
Advance Fee Loan is "pay a fee first, then we send you a loan". Reducing Your Debt (Credit Cards, Mortgage, Student Loans) is forgiveness, consolidation, or a lower rate on a debt the person already has.
Tax Collection is the IRS or back taxes. Calls pretending to be government, businesses, or family and friends covers other agencies, businesses, and family emergencies.
List the verdict categories returns the list with a description of each.

Tactics#

tactics names how the caller pushed, independent of the story. A human analyst reads this list first.
urgency
secrecy
authority_impersonation
remote_access
untraceable_payment
pii_harvest
otp_request
threat
prize_lure
family_fear
refund_bait
callback_pressure
otp_request and remote_access deserve a warning on their own, at any level. A caller who asks for a one-time code or for a remote-access tool is not a legitimate bank.

Intel#

intel is what the caller exposed. It arrives in session.ended and in the scan response. Every field is optional and omitted when empty.
names, organizations, callback_numbers (E.164), emails, urls, crypto_wallets, bank_accounts, card_numbers, gift_card_brands, payment_apps, remote_tools, remote_codes, case_numbers, amounts, addresses, scripts (verbatim lines of the pitch), dtmf (every digit pressed, in order).
With report=true, callback_numbers are filed with the caller. Without it, you still see them and can block them on your side.
Next: What to do with a verdict.
Modified at 2026-09-18 16:56:54
Previous
Send text instead of audio
Next
What to do with a verdict
Built with