---
title: "Get deepfake detection result"
method: GET
path: "/detect/{uuid}"
tags: ["deepfakeDetection"]
---

# Get deepfake detection result

`GET /detect/{uuid}`

Get a deepfake detection result by UUID. The item status describes the Detect job only; Intelligence runs separately and can still be processing after Detect reaches completed.

## Path parameters

- `uuid` string, required

## Query parameters

- `experts` boolean

## Headers

- `Authorization` string, required

## Response `200`

Detection result

- DeepfakeDetectionGetDetectionResponse200
  - `success` boolean
  - `item` DetectUuidGetResponsesContentApplicationJsonSchemaItem
    - `uuid` string
    - `media_type` 'audio' | 'video' | 'image'
    - `status` 'processing' | 'completed' | 'failed' — Status of the Deepfake Detection job only. A completed Detect has verdict and metrics available, but its Intelligence results may still be processing.
    - `metrics` DetectAudioMetrics — Audio detection metrics (for audio and video media types)
      - `label` string, required — Detection label (fake or real)
      - `score` string[], required — Array of prediction scores per chunk
      - `consistency` string, required — Consistency metric across chunks
      - `aggregated_score` string, required — Overall aggregated detection score
      - `image` string — URL to visualization heatmap image (if visualize=true)
    - `image_metrics` DetectImageMetrics — Image detection metrics (for image media type)
      - `type` string, required — Type of image analysis performed
      - `label` string, required — Detection label (fake or real)
      - `image` string, required — URL to visualization image
      - `score` number, double, required — Detection confidence score
      - `children` DetectImageMetricsChildrenItems[], required — Nested analysis results (structure varies by pipeline)
    - `video_metrics` DetectVideoMetrics — Video detection metrics (for video media type)
      - `label` string, required — Overall video detection label
      - `score` number, double, required — Overall detection score
      - `certainty` number, double, required — Overall certainty score
      - `treeview` string — Optional tree visualization data
      - `children` DetectVideoMetricsChildrenItems[], required — Hierarchical detection results across frames
        - `type` string, required
        - `conclusion` string, required
        - `score` number, double, required
        - `certainty` number, double, required
        - `certainty (%)` string, required
        - `children` DetectVideoMetricsChildrenItemsChildrenItems[], required — Frame-level detection results
          - `type` string, required
          - `conclusion` string, required
          - `score` number, double, required
          - `certainty` number, double, required
          - `certainty (%)` string, required
          - `timestamp` number, double, required — Timestamp in seconds
          - `children` DetectVideoMetricsChildrenItemsChildrenItemsChildrenItems[], required — Segment-level detection results
            - `type` string, required
            - `conclusion` string, required
            - `score` number, double, required
            - `certainty` number, double, required
            - `certainty (%)` string, required
    - `c2pa_manifest` DetectC2paManifest — Content Credentials (C2PA) verification result for audio, image, and video media. Returned when verification has completed. A fallback verification failure returns `validation_state: Unavailable` and does not fail the detection.
      - `validation_state` 'Valid' | 'NotPresent' | 'Unavailable' — Verification state. `NotPresent` means no embedded Content Credentials were found; `Unavailable` means verification could not complete.
      - `active_manifest` string, nullable — Active C2PA manifest identifier when credentials are present
      - `manifests` object, nullable — Raw manifest details returned by C2PA tooling
      - `validation_results` object, nullable — Detailed validation results returned by C2PA tooling
      - `message` string, nullable — Generic message when verification is unavailable
    - `audio_source_tracing` DetectUuidGetResponsesContentApplicationJsonSchemaItemAudioSourceTracing — Source tracing results (only returned if audio is labeled fake)
      - `label` string — Identified source (e.g., resemble_ai, elevenlabs) or "real" if audio is not synthetic
      - `error_message` string, nullable
    - `intelligence` union — With experts omitted or false, one completed Intelligence result when available; otherwise, the current processing or failed result. With experts=true, all successfully completed results as an array, or an empty array when none have completed successfully.
      - DetectIntelligenceResult — One Detect Intelligence expert result
        - `uuid` string
        - `status` 'processing' | 'completed' | 'failed' — Status of this Intelligence result, independent of the associated Detect job status.
        - `error_message` string, nullable
        - `description` union
          - string
          - DetectIntelligenceResultDescription1
            - `speaker_info` string
            - `language` string
            - `dialect` string
            - `emotion` string
            - `speaking_style` string
            - `context` string
            - `message` string
            - `abnormalities` string
            - `transcription` string
            - `translation` string, nullable
            - `misinformation` string
            - `fraud` DetectIntelligenceResultDescriptionOneOf1Fraud
              - …
            - `liveness` DetectIntelligenceResultDescriptionOneOf1Liveness
              - …
            - `digitally_altered` DetectIntelligenceResultDescriptionOneOf1DigitallyAltered
              - …
        - `created_at` string, date-time
        - `detect_uuid` string
      - DetectIntelligenceResult[]
        - `uuid` string
        - `status` 'processing' | 'completed' | 'failed' — Status of this Intelligence result, independent of the associated Detect job status.
        - `error_message` string, nullable
        - `description` union
          - string
          - DetectIntelligenceResultDescription1
            - `speaker_info` string
            - `language` string
            - `dialect` string
            - `emotion` string
            - `speaking_style` string
            - `context` string
            - `message` string
            - `abnormalities` string
            - `transcription` string
            - `translation` string, nullable
            - `misinformation` string
            - `fraud` DetectIntelligenceResultDescriptionOneOf1Fraud
              - …
            - `liveness` DetectIntelligenceResultDescriptionOneOf1Liveness
              - …
            - `digitally_altered` DetectIntelligenceResultDescriptionOneOf1DigitallyAltered
              - …
        - `created_at` string, date-time
        - `detect_uuid` string
    - `modality` 'audio' | 'video' | 'all' — Which detection modality was requested for this detect. `all` when not specified (the default). For a single-modality video detect, the skipped component's metrics are absent (`metrics` for audio-only-skipped, `video_metrics` for video-only-skipped).
    - `face_only` boolean — Effective face-only setting for this detect. `true` only for video inputs that include visual analysis; `false` for audio, image, and audio-only video detects.
    - `url` string, nullable — URL to the media file. Null when Zero Retention Mode is enabled.
    - `audio_url` string, nullable — Alias of url. Null when Zero Retention Mode is enabled.
    - `filename` string — Original filename, or tokenized (redacted_<token>.<ext>) when Zero Retention Mode is enabled
    - `duration` number, double
    - `zero_retention_mode` boolean — Whether Zero Retention Mode is enabled for this detect
    - `file_deleted_at` string, date-time, nullable — ISO 8601 timestamp of when the file was purged, or null if not yet deleted
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `404` — Detect not found

## Changes

- **2026-07-31** `bce48b20dad7` — 2 breaking, 3 warning, 2 info
  - added `#/components/schemas/DetectIntelligenceResult, #/components/schemas/DetectUuidGetResponsesContentApplicationJsonSchemaItemIntelligence1` to the `item/intelligence/oneOf[subschema #1: DetectUuidGetResponsesContentApplicationJsonSchemaItemIntelligence]/` response property `oneOf` list for the response status `200`
  - the `item/intelligence/oneOf[subschema #1: DetectUuidGetResponsesContentApplicationJsonSchemaItemIntelligence]/` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the optional property `item/intelligence/oneOf[subschema #1: DetectUuidGetResponsesContentApplicationJsonSchemaItemIntelligence]/created_at` from the response with the `200` status
  - removed the optional property `item/intelligence/oneOf[subschema #1: DetectUuidGetResponsesContentApplicationJsonSchemaItemIntelligence]/description` from the response with the `200` status
  - …3 more
- **2026-07-26** `5e92bebbaf1f` — 1 info
  - added the optional property `item/face_only` to the response with the `200` status

[Change history](https://skmtc.dev/resemble/apis/api-reference/changes/detect/:uuid/get.md)

---

[API](https://skmtc.dev/resemble/apis/api-reference.md) · [All operations](https://skmtc.dev/resemble/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/resemble/api-reference/revisions/e93597a6b425/schema)