Safety & DetectionDeepfake Detection

List Detects

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

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

Query Parameters

ParameterTypeRequiredDefaultDescription
pageinteger✅-Page number (must be >= 1).
page_sizeinteger❌10Number 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      "filename": "file.wav",
24      "duration": 12.5,
25      "visualize": true,
26      "audio_source_tracing_enabled": false,
27      "use_ood_detector": false,
28      "pipeline": null,
29      "extra_params": {},
30      "error_message": null,
31      "created_at": "2025-12-10T15:30:00.000Z",
32      "updated_at": "2025-12-10T15:30:45.000Z"
33    }
34  ]
35}

Response Fields

FieldTypeDescription
uuidstringUnique identifier for the detect object.
media_typestringType of media analyzed: audio, video, or image.
statusstringProcessing status: processing, completed, or failed.
metricsobjectAudio detection results (null if not applicable).
video_metricsobjectVideo detection results (null if not applicable).
image_metricsobjectImage detection results (null if not applicable).
audio_source_tracingobjectSource tracing results (only returned if audio is labeled fake).
intelligenceobjectAudio intelligence report (if requested during creation).
urlstringURL to the analyzed media file.
filenamestringOriginal filename of the media.
durationnumberDuration of the media in seconds.
visualizebooleanWhether heatmap visualization was generated.
audio_source_tracing_enabledbooleanWhether source tracing was enabled.
use_ood_detectorbooleanWhether out-of-distribution detection was used.
pipelinestringAnalysis pipeline used (for video/image).
extra_paramsobjectAdditional custom parameters.
error_messagestringError message if processing failed.
created_atstringISO 8601 timestamp of creation.
updated_atstringISO 8601 timestamp of last update.

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