1. Reference
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. Reference

Limits and thresholds

Prices#

One credit is $0.0039. Current prices are in What this deployment can do.
ProductCreditsPer minute
Filter3 per started minute. The first minute is charged at connect.$0.0117
Filter with tracks=bothTranscription cost doubles
Honeypot8 per started minute$0.0312
Scan, transcript2 per request
Scan, audio2 per request plus 1 per started minute of audio
Number provided by CallerAPI4 more per minute on that number$0.0156
"Your call" means the call reached us from your switch, on the CallerAPI SIP firewall, or on your own Twilio or Telnyx number. When the account runs out of credits, the session ends. The final session.ended event is still sent.

Limits#

LimitValue
Live sessions per node200. Above it the socket answers 503. Retry on a new connection.
Start message timeout10 seconds after the connection.
Filter session60 minutes.
Honeypot session15 minutes.
Honeypot silence8 seconds, three prompts, then hang up.
Sample rate8000 to 48000 Hz.
Encodingspcm16, mulaw.
Final analysisUp to 20 seconds after the call ends.
Scan body25 MB.
Scan request90 seconds.
Webhook post5 seconds, no retry.
Sessions list1 to 200 per request.

Thresholds#

RuleValue
First verdict eventScore 0.3 or more.
Later verdict eventsLevel change, category change, or score move of 0.15.
Rules-only floor0.5. Below it, no event.
Live model passEvery 30 seconds with at least 120 new characters.
scam levelScore 0.85 or more.
Filing by the filterScore 0.85 or more, with report=true.
Filing by the honeypot and /scanScore 0.8 or more.
Never filednone, Advertising, Surveys, Hang Up, No Subject Provided. Other needs 0.85.
Modified at 2026-09-18 16:57:14
Previous
Errors
Next
Production checklist
Built with