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       "metrics": {
13         "label": "real",
14         "score": [0.92, 0.88, 0.95],
15         "aggregated_score": 0.92,
16         "consistency": 0.94,
17         "duration": 12.5
18       },
19       "video_metrics": null,
20       "image_metrics": null,
21       "intelligence": null,
22       "url": "https://storage.example.com/audio/file.wav",
23       "audio_url": "https://storage.example.com/audio/file.wav",
24       "filename": "file.wav",
25       "duration": 12.5,
26       "zero_retention_mode": false,
27       "file_deleted_at": null,
28       "visualize": true,
29       "audio_source_tracing_enabled": false,
30       "use_ood_detector": false,
31       "extra_params": {},
32       "error_message": null,
33       "created_at": "2025-12-10T15:30:00.000Z",
34       "updated_at": "2025-12-10T15:30:45.000Z"
35     }
36   ]
37 }

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`.
`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).
`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
The default page size is 10, with a maximum of 1000 items per page