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

API Key

Add parameter in header

x-auth

Example:

x-auth: ********************

Responses

🟢200The category list

application/json

The category list.

Bodyapplication/json

🟠401Missing or wrong API key

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.callerapi.com/api/voice/categories' \
--header 'x-auth: <api-key>'

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

What this deployment can do

List the honeypot personas