1. REST
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
  • 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
          GET
        • List the verdict categories
          GET
        • List the honeypot personas
          GET
        • Score a transcript or a recording
          POST
        • List your recent sessions
          GET
        • Get one session with verdict and intel
          GET
        • Twilio voice URL for a screened number
          POST
        • Preview the Twilio TwiML
          GET
        • Telnyx voice URL for a screened number
          POST
        • Twilio voice URL for a honeypot number
          POST
        • Telnyx voice URL for a honeypot number
          POST
      • 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
  • Business Caller ID
    • Get started
    • Quickstart
      • Announce a call
      • Verify at INVITE
      • What you get
    • Verdicts
      • Show the name and logo
      • Read a verdict
    • REST
      • Verify the calling number
      • Fetch the logo
      • Announce a call
  • DID monitoring
    • Get started
    • Reference
      • Statuses and labels
      • Webhooks
      • Billing and limits
      • Errors
    • REST
      • Submit numbers
      • List number status
      • Read one number
      • Remove a number
      • Read the check schedule
      • Set the check schedule
      • Save the webhook URL
      • Read the webhook
      • Delete the webhook
      • Send a test event
      • Rotate the webhook secret
    • Number flagged
    • Number cleared
  • Signer reputation by SPC
    GET
  • Signers ranked by score
    GET
  • Schemas
    • Spam protection
      • Spam score request
      • Business info
      • Carrier info
      • Complaint (without number)
      • Daily spam reports request
      • Complaint (with phone)
    • Signer
    • SubmitResponse
    • Monitoring
    • Number
    • NumberListResponse
    • OneNumberResponse
    • ScheduleResponse
    • WebhookWriteResponse
    • WebhookReadResponse
    • FlaggedEvent
    • ClearedEvent
    • EventData
    • Error
    • AuthError
    • ScheduleRequest
    • WebhookRequest
    • RemovedResponse
    • WebhookTestResponse
  1. REST

List the verdict categories

GET
/api/voice/categories
Every value verdict.category can take, with a description. The values are the exact CallerAPI complaint subjects, so a filed complaint carries the same string as GET /api/lookup/{phone}. none means a clean call. Free.

Request

Authorization

Responses

🟢200The category list
application/json
The category list.
Bodyapplication/json

🟠401Missing or wrong API key
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.callerapi.com/api/voice/categories'
Response Response Example
200 - The category list
{
  "status": "success",
  "categories": [
    {
      "category": "Advance Fee Loan",
      "label": "Advance Fee Loan",
      "description": "Pay a fee, deposit, insurance, or 'processing' charge first, then they will send a loan. The loan never comes.",
      "ftc_subject": "Advance Fee Loan"
    },
    {
      "category": "none",
      "label": "none",
      "description": "Not a scam.",
      "ftc_subject": ""
    }
  ]
}
Modified at 2026-09-18 16:51:43
Previous
What this deployment can do
Next
List the honeypot personas
Built with