Skip to main content
POST
Deepfake scan
This endpoint does not download or inspect the referenced image, video, or document. It scores indicators or scores supplied by your application. Values are heuristic risk scores, not calibrated probabilities. The authentic label means the configured risk threshold was not reached; it is not proof that media is authentic, especially when no indicators were supplied.

How detection works

Scans use a heuristic signal engine (heuristic_v1) that accepts caller-provided signals (from external ML models, rule engines, or manual review) and maps them to weighted scores:
  • Deepfake indicators: face swap, inconsistent lighting, compression artifacts, temporal inconsistency, metadata mismatch
  • Impersonation indicators: biometric mismatch, name mismatch, identity doc mismatch, issuer trust violation
Scores ≥ 75 set verdict deepfake or impersonation. Scores ≥ 40 set suspect. Scores ≥ 60 automatically ingest a risk signal. You can also bypass heuristic analysis by passing pre-computed deepfake_score and impersonation_score values directly. The platform still applies the same verdict thresholds and automatic signal ingestion. See the deepfake detection guide for the full workflow, indicator reference, and additional examples.

Response

string
UUID of the scan result.
string
The subject reference that was scanned.
string
Type of subject: image, video, document, attestation, identity
integer
Deepfake heuristic risk score (0–100).
integer
Impersonation heuristic risk score (0–100).
string
authentic | suspect | deepfake | impersonation
array
List of triggered indicators from the scan.
string
Detection model used (e.g. heuristic_v1).
string
UUID of the auto-ingested risk signal (only present when score ≥ 60).
string
UUID of the linked attestation, if one was provided during the scan.
string
ISO 8601 timestamp of when the scan was performed.

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Body

application/json
subject_ref
string
required

Reference identifier for the subject

subject_type
string
required
attestation_id
string
deepfake_score
integer | null
impersonation_score
integer | null
signals
string[]

Response

Scan initiated

scan_id
string
status
string
subject_ref
string