Score a transcript or a recording

Classify one call after the fact. Send a transcript, or audio as base64 or as a multipart file named audio. Exactly one of transcript or audio is required. Costs 2 credits per request plus 1 credit per started minute of uploaded audio. A request rejected with 400 costs nothing. The body limit is 25 MB. The request times out after 90 seconds.

With report=true and from present, a score of 0.8 or more files the caller and every callback number as a complaint. none, Advertising, Surveys, Hang Up, and No Subject Provided are never filed. Other needs 0.85.

Multipart is also accepted: a file field named audio plus the same fields as form values.

Responses

🟢200The verdict, the intel, and the transcript

application/json

The verdict, the intel, and the transcript.

Bodyapplication/json

🟠400Bad input

🟠401Missing or wrong API key

🟠402Insufficient credits

🔴502Transcription failed

🔴503Audio was sent but speech recognition is off on this deploym

curl --location 'https://api.callerapi.com/api/voice/scan' \ --header 'x-auth: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "transcript": "This is officer Smith from Social Security. Pay with gift cards today or you will be arrested.", "from": "+15559990000", "report": false }'

{ "status": "success", "session_id": "3f0c1a2e-8b1d-4f7e-9c2a-1d2e3f4a5b6c", "verdict": { "score": 0.93, "level": "scam", "category": "Calls pretending to be government, businesses, or family and friends", "tactics": [ "authority_impersonation", "threat", "untraceable_payment", "urgency" ], "signals": [ "invokes Social Security", "asks for gift cards", "threatens arrest or legal action" ], "summary": "Caller impersonates Social Security and demands gift cards under threat of arrest.", "source": "combined" }, "intel": {}, "transcript": "This is officer Smith from Social Security. Pay with gift cards today or you will be arrested.", "reported": false, "reported_numbers": 0 }

Request

Responses