Get Detection Result | Resemble

GET https://app.resemble.ai/api/v2/detect/{uuid}

Retrieve the deepfake detection result using the provided UUID. Returns the final metrics for the detection job. Media-type-specific keys appear depending on the input.

$ curl --request GET 'https://app.resemble.ai/api/v2/detect/DETECT_UUID' \
>   -H 'Authorization: Bearer YOUR_API_TOKEN'

Response Details

metrics - Always includes a label (fake/real), score array with predictions per chunk, consistency field (for audio/video), and aggregated_score
image_metrics - Present for still images, contains type, label, score, visualization image (if requested), and nested analysis children
video_metrics - Present for videos, includes nested detections across frames with timestamps, certainty scores, and hierarchical results
audio_source_tracing - Present when audio is labeled as fake. Contains label identifying the likely source (e.g., resemble_ai, elevenlabs) or real if audio is not synthetic, and error_message (null on success)
intelligence - Present when intelligence analysis was requested. Contains uuid, description, created_at timestamp, and detect_uuid
zero_retention_mode - Boolean indicating whether Zero Retention Mode was enabled for this detect
media_redacted - Boolean, true when Zero Retention Mode is active and media URLs are redacted
media_deleted - Boolean, true when the source file has been permanently deleted from storage
file_deleted_at - ISO 8601 timestamp of when the file was purged, or null if not yet deleted
audio_url - Alias of url. Both are null when Zero Retention Mode is enabled

1 {
2   "success": true,
3   "item": {
4     "uuid": "DETECTION_UUID",
5     "media_type": "audio",
6     "status": "completed",
7     "metrics": {
8       "label": "fake",
9       "score": ["0.9", "0.8", "0.7"],
10       "consistency": "0.85",
11       "aggregated_score": "0.566"
12     },
13     "image_metrics": {
14       "ifl": {
15         "score": 1,
16         "heatmap": "https://..."
17       },
18       "type": "FinalResult",
19       "label": "Fake",
20       "image": "https://...",
21       "score": 1,
22       "children": []
23     },
24     "video_metrics": {
25       "label": "Fake",
26       "score": "0.9",
27       "certainty": "0.9",
28       "treeview": "...",
29       "children": [
30         {
31           "type": "VideoResult",
32           "conclusion": "Fake",
33           "score": "0.99",
34           "certainty": "0.9",
35           "children": [
36             {
37               "type": "ImageResult",
38               "conclusion": "Fake",
39               "score": "0.9",
40               "certainty": "0.95",
41               "timestamp": "0.23",
42               "children": [
43                 {
44                   "type": "Segment",
45                   "conclusion": "Fake",
46                   "score": "0.9",
47                   "certainty": "0.995"
48                 }
49               ]
50             }
51           ]
52         }
53       ]
54     },
55     "audio_source_tracing": {
56       "label": "resemble_ai",
57       "error_message": null
58     },
59     "intelligence": {
60       "uuid": "INTELLIGENCE_UUID",
61       "description": "Adult male speaker with confident tone discussing...",
62       "created_at": "2024-01-15T10:30:05Z",
63       "detect_uuid": "DETECTION_UUID"
64     },
65     "url": "https://storage.example.com/audio/suspicious.wav",
66     "audio_url": "https://storage.example.com/audio/suspicious.wav",
67     "filename": "suspicious.wav",
68     "duration": 8.2,
69     "zero_retention_mode": false,
70     "media_redacted": false,
71     "media_deleted": false,
72     "file_deleted_at": null,
73     "created_at": "2024-01-15T10:30:00Z",
74     "updated_at": "2024-01-15T10:30:05Z"
75   }
76 }

metrics always reflects the aggregate prediction and confidence per chunk.
image_metrics appears for still images and contains visualization assets if requested.
video_metrics nests detections across frames with timestamps and certainty percentages.
audio_source_tracing is only returned when audio is labeled as fake. Use the standalone Audio Source Tracing endpoints to access all source tracing reports.

Zero Retention Mode Response

When zero_retention_mode was enabled on the original request, media URLs are redacted and the filename is tokenized:

1 {
2   "success": true,
3   "item": {
4     "uuid": "DETECTION_UUID",
5     "media_type": "audio",
6     "status": "completed",
7     "metrics": {
8       "label": "fake",
9       "score": ["0.9", "0.8", "0.7"],
10       "consistency": "0.85",
11       "aggregated_score": "0.566"
12     },
13     "url": null,
14     "audio_url": null,
15     "filename": "redacted_abc123def4567890abcd1234.wav",
16     "duration": 8.2,
17     "zero_retention_mode": true,
18     "media_redacted": true,
19     "media_deleted": true,
20     "file_deleted_at": "2024-01-15T10:31:00Z",
21     "created_at": "2024-01-15T10:30:00Z",
22     "updated_at": "2024-01-15T10:30:05Z"
23   }
24 }

Error Response (404)

1 {
2   "success": false,
3   "message": "Detect not found"
4 }