Signal

The Signal API scores a piece of content — text, audio, image, or video — against a set of fraud and scam categories and returns a verdict along with the best-matching categories. Use it to triage suspicious messages, voicemails, and media, and to explain why something looks fraudulent.

Signal ships with a built-in catalog of fraud patterns. Teams can extend or replace that catalog with their own custom categories built from example phrases.

Base URL

https://app.resemble.ai/api/v2

Send Content-Type: application/json for text and JSON bodies, and multipart/form-data for file uploads.

Access

Signal requires an account with Signal enabled. Requests from accounts without access return:

1{
2 "success": false,
3 "message": "Signal access is required"
4}

All calls are scoped to the authenticated user’s team automatically.

Verdicts

Every submission returns one of three verdicts:

VerdictMeaning
safeNo meaningful match against any fraud category.
suspiciousMatched a fraud category, but not strongly enough to be conclusive.
fraudStrong match against one or more fraud categories.

The verdict is accompanied by the highest-scoring category, the runner-up categories, and the individual example phrases that matched — see Score Content for the full response shape.

Supported input

InputHow to send itLimits
Texttext field in a JSON body
Audiofile in a multipart body15 MB
Imagefile in a multipart body15 MB
Videofile in a multipart body15 MB

Provide either text or file in a request, not both. The media type is detected from the uploaded file’s MIME type, and can be overridden with media_type.

Endpoints

MethodPathPurpose
POST/signalScore text or a media file
GET/signalList past submissions
DELETE/signal/{id}Delete a submission
GET/signal/custom_categoriesList categories, settings, and calibration
POST/signal/custom_categoriesCreate a custom category
GET/signal/custom_categories/{id}Get a custom category
PATCH/signal/custom_categories/{id}Update a custom category
DELETE/signal/custom_categories/{id}Delete a custom category
PATCH/signal/settingsToggle the built-in categories