curl --request GET \
--url https://api.prd.realitydefender.xyz/api/media/users/{requestId} \
--header 'X-Api-Key: <api-key>'import requests
url = "https://api.prd.realitydefender.xyz/api/media/users/{requestId}"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://api.prd.realitydefender.xyz/api/media/users/{requestId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.prd.realitydefender.xyz/api/media/users/{requestId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.prd.realitydefender.xyz/api/media/users/{requestId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.prd.realitydefender.xyz/api/media/users/{requestId}")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.prd.realitydefender.xyz/api/media/users/{requestId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"filename": "your_file_1736942400000.mp4",
"originalFileName": "your-file.mp4",
"requestId": "8b0d4c1e-2f3a-4b5c-8d6e-7f8a9b0c1d2e",
"uploadedDate": "2025-01-15T12:00:00.000Z",
"mediaType": "VIDEO",
"showAudioResult": true,
"audioRequestId": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"userId": "user_0123456789abcdef",
"institutionId": "3f2a1b4c-5d6e-4f70-8a9b-0c1d2e3f4a5b",
"releaseVersion": "2.3.1",
"overallStatus": "AUTHENTIC",
"resultsSummary": {
"status": "AUTHENTIC",
"metadata": {
"finalScore": 12
}
},
"models": [
{
"name": "rd-vid-ensemble",
"data": {
"score": 0.12,
"decision": "AUTHENTIC",
"raw_score": 0.12
},
"status": "AUTHENTIC",
"predictionNumber": 0.12,
"normalizedPredictionNumber": 12,
"rollingAvgNumber": null,
"finalScore": 12
}
],
"storageLocation": "https://<bucket>.s3.amazonaws.com/<key>?X-Amz-Expires=900&...",
"thumbnail": "https://<bucket>.s3.amazonaws.com/<key>/thumbnail.png?X-Amz-Expires=900&...",
"aggregationResultUrl": "3f2a1b4c-5d6e-4f70-8a9b-0c1d2e3f4a5b/8b0d4c1e-2f3a-4b5c-8d6e-7f8a9b0c1d2e/aggregation.json",
"modelMetadataUrl": "https://<bucket>.s3.amazonaws.com/<key>/aggregation.json?X-Amz-Expires=900&...",
"audioModelMetadataUrl": "https://<bucket>.s3.amazonaws.com/<audio-key>/aggregation.json?X-Amz-Expires=900&...",
"heatmaps": {
"rd-vid-ensemble": "https://<bucket>.s3.amazonaws.com/<key>/heatmaps/rd-vid-ensemble/heatmap.png?X-Amz-Expires=900&..."
},
"explainabilityUrl": ""
}Get a scan result
Returns the result for one uploaded file or social media URL. The
requestId comes from the POST /api/files/aws-presigned or
POST /api/files/social response, or from the URL of the result in the
web app. Poll this endpoint until overallStatus is no longer
ANALYZING or DOWNLOADING.
Rely on the ensemble result (overallStatus and resultsSummary)
rather than on individual models[] results.
Score interpretation
When a score is present, it maps to one of three conclusions. The same
bands apply to the overall score (resultsSummary.metadata.finalScore)
and to each model’s finalScore.
| Conclusion | Score | API status | Guidance |
|---|---|---|---|
| Authentic | 1–44 | AUTHENTIC | Low likelihood of manipulation or AI generation; continue normal workflows |
| Suspicious | 45–55 | SUSPICIOUS | Moderate likelihood of manipulation; worth a closer look or human review |
| Manipulated | 56–99 | FAKE | High likelihood that the content has been manipulated or AI-generated; trigger escalation or secondary validation |
The status comes from the ensemble’s decision, and the context model can override it. The bands describe how the scores line up; they are not a rule the API applies separately.
Scores are always > 0 and < 100. A higher score means a higher
likelihood of manipulation; it does not mean the entire file is
synthetic, or that every frame, second or pixel was generated. When
the context model sets the conclusion, finalScore may be null; use
overallStatus.
NOT_APPLICABLE and UNABLE_TO_EVALUATE
NOT_APPLICABLE means the media has characteristics known to affect
accuracy. The reasons are listed in resultsSummary.metadata.reasons.
- Image: for example
relevance: no faces detected/faces too small,size: face too small,quality: face too blurry - Audio: for example
duration: audio too short (<1.5s),duration: silence removed audio too short (<1.5s),loudness: audio too quiet, dialtone and/or music (detected: ...),cross-talk: more than one speaker detected,quality: audio too noisy,language - Video: reasons may be empty (for example
duration: video too long); usemodelMetadataUrlfor timeline and scene detail.
UNABLE_TO_EVALUATE means an error occurred while processing the file,
for example a model timeout or failure. The error is described in
resultsSummary.error.
Visualization artifacts
aggregationResultUrl is the storage key of the scan’s
aggregation.json, shaped like
{organizationId}/{requestId}/aggregation.json (older scans may use a
legacy layout); it is not a downloadable URL. modelMetadataUrl is the pre-signed URL of that same
file, and for combined video and audio scans audioModelMetadataUrl
points at the extracted-audio aggregation JSON. The Reality Defender UI
loads this JSON to render report detail. Approximate contents:
- Image:
bboxes,conclusions, optionalcontextResult - Video: frame and timeline fields (scenes, frames, tubes),
models,ensembles,conclusions, optionalcontextResult - Audio:
chunks,languages,conclusions,models,ensembles, plus audio metadata - Text:
models,ensembles,conclusions
From a client, download modelMetadataUrl / audioModelMetadataUrl,
not aggregationResultUrl.
Pre-signed URL expiry
heatmaps, thumbnail, storageLocation, modelMetadataUrl,
audioModelMetadataUrl and explainabilityUrl are pre-signed URLs
that expire after 15 minutes (X-Amz-Expires=900). Call this endpoint
again for the same requestId to get fresh URLs.
Models
Model names are not a stable contract: detectors can be added, renamed
or removed. Always read models[].name from the response rather than
hard-coding slugs. Illustrative examples:
- Image:
rd-cedar-img,rd-elm-img,rd-oak-img,rd-pine-img,rd-img-ensemble,rd-context-img - Video:
rd-erie-vid,rd-tahoe-vid,rd-dynamics-vid,rd-vid-ensemble,rd-context-vid - Audio:
rd-slim-aud,rd-everest-aud,rd-aud-ensemble - Text:
rd-llm-txt
The set reflects the detectors live at upload time; a context model reports NOT_APPLICABLE when context models are disabled for the organization.
curl --request GET \
--url https://api.prd.realitydefender.xyz/api/media/users/{requestId} \
--header 'X-Api-Key: <api-key>'import requests
url = "https://api.prd.realitydefender.xyz/api/media/users/{requestId}"
headers = {"X-Api-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};
fetch('https://api.prd.realitydefender.xyz/api/media/users/{requestId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.prd.realitydefender.xyz/api/media/users/{requestId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.prd.realitydefender.xyz/api/media/users/{requestId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.prd.realitydefender.xyz/api/media/users/{requestId}")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.prd.realitydefender.xyz/api/media/users/{requestId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"filename": "your_file_1736942400000.mp4",
"originalFileName": "your-file.mp4",
"requestId": "8b0d4c1e-2f3a-4b5c-8d6e-7f8a9b0c1d2e",
"uploadedDate": "2025-01-15T12:00:00.000Z",
"mediaType": "VIDEO",
"showAudioResult": true,
"audioRequestId": "1a2b3c4d-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
"userId": "user_0123456789abcdef",
"institutionId": "3f2a1b4c-5d6e-4f70-8a9b-0c1d2e3f4a5b",
"releaseVersion": "2.3.1",
"overallStatus": "AUTHENTIC",
"resultsSummary": {
"status": "AUTHENTIC",
"metadata": {
"finalScore": 12
}
},
"models": [
{
"name": "rd-vid-ensemble",
"data": {
"score": 0.12,
"decision": "AUTHENTIC",
"raw_score": 0.12
},
"status": "AUTHENTIC",
"predictionNumber": 0.12,
"normalizedPredictionNumber": 12,
"rollingAvgNumber": null,
"finalScore": 12
}
],
"storageLocation": "https://<bucket>.s3.amazonaws.com/<key>?X-Amz-Expires=900&...",
"thumbnail": "https://<bucket>.s3.amazonaws.com/<key>/thumbnail.png?X-Amz-Expires=900&...",
"aggregationResultUrl": "3f2a1b4c-5d6e-4f70-8a9b-0c1d2e3f4a5b/8b0d4c1e-2f3a-4b5c-8d6e-7f8a9b0c1d2e/aggregation.json",
"modelMetadataUrl": "https://<bucket>.s3.amazonaws.com/<key>/aggregation.json?X-Amz-Expires=900&...",
"audioModelMetadataUrl": "https://<bucket>.s3.amazonaws.com/<audio-key>/aggregation.json?X-Amz-Expires=900&...",
"heatmaps": {
"rd-vid-ensemble": "https://<bucket>.s3.amazonaws.com/<key>/heatmaps/rd-vid-ensemble/heatmap.png?X-Amz-Expires=900&..."
},
"explainabilityUrl": ""
}Authorizations
Response
The scan result
Status of a scan:
ANALYZING— analysis is in progress.NOT_APPLICABLE— the media has characteristics known to affect accuracy; seeresultsSummary.metadata.reasons.UNABLE_TO_EVALUATE— processing failed, for example a model timeout or failure; seeresultsSummary.error.DOWNLOADING— a social media URL is still being downloaded.DOWNLOAD_FAILED— the social media URL could not be downloaded; seeresultsSummary.error.AUTHENTIC— conclusion Authentic (score typically 1–44).FAKE— conclusion Manipulated (score typically 56–99).SUSPICIOUS— conclusion Suspicious (score typically 45–55).
ANALYZING, NOT_APPLICABLE, UNABLE_TO_EVALUATE, DOWNLOADING, DOWNLOAD_FAILED, AUTHENTIC, FAKE, SUSPICIOUS