Skip to main content
GET
Get a scan result

Authorizations

X-Api-Key
string
header
required

API key created in the web app under API keys. Expired or disabled keys are rejected with 401.

Path Parameters

requestId
string
required

Request ID of the upload or social media submission.

Response

The scan result

requestId
string

ID used to fetch this result.

name
string

Storage key of the uploaded media object. Use scanName for display.

scanName
string

Name given to the scan.

filename
string

Display / upload file name.

originalFileName
string

Original uploaded file name.

mediaType
string

IMAGE, VIDEO, AUDIO or TEXT.

overallStatus
enum<string>

Status of a scan:

  • ANALYZING — analysis is in progress.
  • NOT_APPLICABLE — the media has characteristics known to affect accuracy; see resultsSummary.metadata.reasons.
  • UNABLE_TO_EVALUATE — processing failed, for example a model timeout or failure; see resultsSummary.error.
  • DOWNLOADING — a social media URL is still being downloaded.
  • DOWNLOAD_FAILED — the social media URL could not be downloaded; see resultsSummary.error.
  • AUTHENTIC — conclusion Authentic (score typically 1–44).
  • FAKE — conclusion Manipulated (score typically 56–99).
  • SUSPICIOUS — conclusion Suspicious (score typically 45–55).
Available options:
ANALYZING,
NOT_APPLICABLE,
UNABLE_TO_EVALUATE,
DOWNLOADING,
DOWNLOAD_FAILED,
AUTHENTIC,
FAKE,
SUSPICIOUS
origin
string

API key name (or redacted key), Social link, or Uploaded.

Social media URL. Always present; meaningful only for social media submissions.

Whether the social media URL was downloaded. Always present; meaningful only for social media submissions.

Whether downloading the social media URL failed. Always present; meaningful only for social media submissions.

showAudioResult
boolean

For video scans, whether the extracted-audio result is included in this result. Set at upload from the request or the organization's auto audio analysis setting, or later when audio analysis is requested. Usually false for non-video media.

audioRequestId
string | null

Request ID of the extracted-audio scan, set for every video scan; '' or null otherwise.

thumbnail
string

Pre-signed thumbnail URL, or "" when unavailable.

userId
string

ID of the uploading user.

institutionId
string | null

Organization ID.

releaseVersion
string

Platform release version used for the scan; defaults to 1.0.0.

uploadedDate
string

Upload timestamp (ISO 8601).

createdAt
string<date-time>

Creation timestamp.

updatedAt
string<date-time>

Last update timestamp.

resultsSummary
object | null

Ensemble status, score, and optional reasons or error.

models
object[]

Per-model detection results. Missing or in-flight models may appear with status: ANALYZING and null scores. Models that do not apply to the media type typically return status: NOT_APPLICABLE with code: not_applicable and data: null.

rdModels
object[]
storageLocation
string

Pre-signed URL of the original uploaded media. May be empty if the original was deleted by the retention policy.

aggregationResultUrl
string

Storage key of the scan's aggregation.json. Not a downloadable URL; use modelMetadataUrl instead.

modelMetadataUrl
string

Pre-signed URL of the aggregation.json referenced by aggregationResultUrl. Fetch it to build UI-like visualizations.

audioModelMetadataUrl
string

Pre-signed URL of the extracted-audio aggregation JSON for video scans once the audio scan has finished; otherwise "".

explainabilityUrl
string

Pre-signed URL of the HTML explainability output, for text scans. Always "" for image, video and audio.

heatmaps
object

Map of model name to pre-signed heatmap PNG URL, one entry per models[] item.

tags
object[]

Labels attached to the scan.