Skip to main content

Risk API

Risk endpoints exposed by the Devotel CPaaS API Base path: /api/v1/risk/score Endpoint count: 1

Unified cross-channel Trust & Fraud risk score for a destination

POST /api/v1/risk/score
Fuses the platform’s existing anti-fraud detectors into one composite risk verdict a tenant can query BEFORE committing an SMS send or a call. The live SMS-pumping / artificial-traffic score and (when a message body is supplied) the outbound URL/link-reputation score are always computed; the caller’s own Verify Fraud Guard and Voice Biometrics scores are folded in as optional pass-through inputs. Returns a 0-100 composite score (the worst present channel score), a band (low/elevated/high/critical), an advisory recommendation (allow/review/block), and a transparent per-channel breakdown so the composite is never a black box. Read-only and advisory: it sends nothing, routes nothing, and enforces nothing — the Devotel softswitch remains the sole outbound path. Rate-limited to 120 requests/minute per tenant.
string
required
Destination the score is requested for, in E.164 format (e.g. +14155552671).
string (enum: sms|whatsapp|voice|verify)
Channel the score is being requested for — drives the SMS-pumping velocity aggregate.
string
Optional outbound message body. When supplied, every URL in it is reputation-scanned and folded into the composite.
object
Optional pass-through score from the caller’s own Verify Fraud Guard evaluation for this recipient this session.
object
Optional pass-through score from the caller’s own Voice Biometrics challenge for this session.