Skip to main content
GET
/
v1
/
risk
/
deepfake
/
results
/
{subject_ref}
Get deepfake results
curl --request GET \
  --url https://api.truthlocks.com/v1/risk/deepfake/results/{subject_ref} \
  --header 'X-API-Key: <api-key>'
{
  "subject_ref": "<string>",
  "verdict": "authentic",
  "confidence": 123,
  "scans": [
    {}
  ]
}
Returns the latest scan result for the specified subject_ref. Use this to check the current deepfake and impersonation status of a previously scanned subject without re-running the scan.

​
Path parameters

​
subject_ref
string
required
The subject reference used when the scan was submitted — a URL, SHA-256 hash, attestation ID, or opaque identifier.

​
Response

​
scan_id
string
UUID of the scan result.
​
subject_ref
string
The subject reference that was scanned.
​
subject_type
string
Type of subject: image, video, document, attestation, identity
​
deepfake_score
integer
Deepfake probability score (0–100).
​
impersonation_score
integer
Impersonation probability score (0–100).
​
verdict
string
authentic | suspect | deepfake | impersonation
​
indicators
array
List of triggered indicators from the scan.
​
detection_model
string
Detection model used (e.g. heuristic_v1).
​
signal_id
string
UUID of the auto-ingested risk signal, if the score met the threshold (≥ 60).
​
attestation_id
string
UUID of the linked attestation, if one was provided during the scan.
​
created_at
string
ISO 8601 timestamp of when the scan was performed.

Authorizations

​
X-API-Key
string
header
required

API key for machine-to-machine authentication

Path Parameters

​
subject_ref
string
required

Subject reference from the scan request

Response

Scan results

​
subject_ref
string
​
verdict
enum<string>
Available options:
authentic,
deepfake,
inconclusive
​
confidence
number
​
scans
object[]