---
title: "List all detects"
method: GET
path: "/detect"
tags: ["deepfakeDetection"]
---

# List all detects

`GET /detect`

Retrieve a paginated list of all detect objects for the authenticated user's team

## Query parameters

- `page` integer, required
- `page_size` integer

## Headers

- `Authorization` string, required

## Response `200`

List of detects

- DeepfakeDetectionListDetectionsResponse200
  - `success` boolean
  - `page` integer
  - `num_pages` integer
  - `page_size` integer
  - `total_count` integer
  - `items` DetectGetResponsesContentApplicationJsonSchemaItemsItems[]
    - `uuid` string
    - `media_type` 'audio' | 'video' | 'image'
    - `status` 'processing' | 'completed' | 'failed'
    - `modality` 'audio' | 'video' | 'all' — Which detection modality was requested. `all` when not specified (the default). Only meaningful for video detects.
    - `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.
    - `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` DetectGetResponsesContentApplicationJsonSchemaItemsItemsAudioSourceTracing — 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` DetectGetResponsesContentApplicationJsonSchemaItemsItemsIntelligence
    - `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 was 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
    - `visualize` boolean
    - `audio_source_tracing_enabled` boolean
    - `use_ood_detector` boolean
    - `pipeline` string, nullable — Legacy field. May be present on older image/video detects. Ignored on create for new detections.
    - `extra_params` DetectGetResponsesContentApplicationJsonSchemaItemsItemsExtraParams
    - `error_message` string, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Changes

- **2026-08-22** `e93597a6b425` — 3 warning, 1 info
  - for the `query` request parameter `page_size`, the max was set to `1000.00`
  - for the `query` request parameter `page`, the min was set to `1.00`
  - for the `query` request parameter `page_size`, the min was set to `10.00`
  - response property `items/items/pipeline` deprecated
- **2026-07-31** `bce48b20dad7` — 1 info
  - added the optional property `items/items/c2pa_manifest` to the response with the `200` status
- **2026-07-26** `5e92bebbaf1f` — 1 info
  - added the optional property `items/items/face_only` to the response with the `200` status

[Change history](https://skmtc.dev/resemble/apis/api-reference/changes/detect/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)