List Detects | Resemble | Documentation

GET https://app.resemble.ai/api/v2/detect

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

Query Parameters

Parameter	Type	Required	Default	Description
`page`	integer	✅	-	Page number (must be >= 1).
`page_size`	integer	❌	10	Number of items per page (10-1000).

Example Request

$ curl 'https://app.resemble.ai/api/v2/detect?page=1&page_size=20' \
>   -H 'Authorization: Bearer YOUR_API_TOKEN'

Response

1 {
2   "success": true,
3   "page": 1,
4   "num_pages": 5,
5   "page_size": 20,
6   "total_count": 87,
7   "items": [
8     {
9       "uuid": "a1b2c3d4e5f6...",
10       "media_type": "audio",
11       "status": "completed",
12       "face_only": false,
13       "metrics": {
14         "label": "real",
15         "score": [0.92, 0.88, 0.95],
16         "aggregated_score": 0.92,
17         "consistency": 0.94,
18         "duration": 12.5
19       },
20       "video_metrics": null,
21       "image_metrics": null,
22       "intelligence": null,
23       "watermark": {
24         "status": "completed",
25         "metrics": {
26           "overall_status": "absent",
27           "detected_model_versions": [],
28           "coverage_complete": true,
29           "has_watermark": {
30             "channel_0": false
31           },
32           "confidence": 0.0,
33           "model_results": [
34             {
35               "model_version": "perth_v1",
36               "status": "succeeded",
37               "detected": false
38             },
39             {
40               "model_version": "perth_v2",
41               "status": "succeeded",
42               "detected": false
43             }
44           ],
45           "synthid": false
46         }
47       },
48       "url": "https://storage.example.com/audio/file.wav",
49       "audio_url": "https://storage.example.com/audio/file.wav",
50       "filename": "file.wav",
51       "duration": 12.5,
52       "zero_retention_mode": false,
53       "file_deleted_at": null,
54       "visualize": true,
55       "audio_source_tracing_enabled": false,
56       "use_ood_detector": false,
57       "extra_params": {},
58       "error_message": null,
59       "created_at": "2025-12-10T15:30:00.000Z",
60       "updated_at": "2025-12-10T15:30:45.000Z"
61     }
62   ]
63 }

Response Fields

Field	Type	Description
`uuid`	string	Unique identifier for the detect object.
`media_type`	string	Type of media analyzed: `audio`, `video`, or `image`.
`status`	string	Processing status: `processing`, `completed`, or `failed`. An otherwise successful Detect waits for requested Watermark analysis; a core detection failure still reports `failed`.
`face_only`	boolean	Effective face-only setting. `true` only for video detects that included visual analysis; otherwise `false`.
`metrics`	object	Audio detection results (null if not applicable).
`video_metrics`	object	Video detection results (null if not applicable).
`image_metrics`	object	Image detection results (null if not applicable).
`audio_source_tracing`	object	Source tracing results (only returned if audio is labeled `fake`).
`intelligence`	object	Intelligence report (if requested during creation).
`watermark`	object	Watermark analysis state and results when `detect_watermark=true` was requested. Omitted otherwise.
`url`	string	URL to the analyzed media file. `null` when Zero Retention Mode is enabled.
`audio_url`	string	Alias of `url`. `null` when Zero Retention Mode is enabled.
`filename`	string	Original filename of the media. Tokenized (e.g., `redacted_<token>.<ext>`) when Zero Retention Mode is enabled.
`zero_retention_mode`	boolean	Whether Zero Retention Mode was enabled for this detect.
`file_deleted_at`	string \| null	ISO 8601 timestamp of when the file was purged, or `null` if not yet deleted. Use this to determine whether the source media has been purged.
`duration`	number	Duration of the media in seconds.
`visualize`	boolean	Whether heatmap visualization was generated.
`audio_source_tracing_enabled`	boolean	Whether source tracing was enabled.
`use_ood_detector`	boolean	Whether out-of-distribution detection was used.
`extra_params`	object	Additional custom parameters.
`error_message`	string	Error message if processing failed.
`created_at`	string	ISO 8601 timestamp of creation.
`updated_at`	string	ISO 8601 timestamp of last update.

Legacy Response Fields

Field	Type	Description
`pipeline`	`string \| null`	Deprecated field that may appear on older image/video detects returned by the API. Ignored on create for new detections.

Notes

All endpoints return resources scoped to the authenticated user’s team
audio_source_tracing results are only returned when the audio detection result is labeled as fake
watermark is omitted for detects created without watermark analysis; nested failures do not change the deepfake verdict
The default page size is 10, with a maximum of 1000 items per page