Get Detection Result

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
  • modality - For video detects, which components were requested: audio, video, or all (default). When a single modality was requested, the skipped component’s metrics are absent (video_metrics for audio, metrics for video) and the detect still reaches completed
  • 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
  • file_deleted_at - 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 from storage.
  • 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 "modality": "all",
8 "metrics": {
9 "label": "fake",
10 "score": ["0.9", "0.8", "0.7"],
11 "consistency": "0.85",
12 "aggregated_score": "0.566"
13 },
14 "image_metrics": {
15 "ifl": {
16 "score": 1,
17 "heatmap": "https://..."
18 },
19 "type": "FinalResult",
20 "label": "Fake",
21 "image": "https://...",
22 "score": 1,
23 "children": []
24 },
25 "video_metrics": {
26 "label": "Fake",
27 "score": "0.9",
28 "certainty": "0.9",
29 "treeview": "...",
30 "children": [
31 {
32 "type": "VideoResult",
33 "conclusion": "Fake",
34 "score": "0.99",
35 "certainty": "0.9",
36 "children": [
37 {
38 "type": "ImageResult",
39 "conclusion": "Fake",
40 "score": "0.9",
41 "certainty": "0.95",
42 "timestamp": "0.23",
43 "children": [
44 {
45 "type": "Segment",
46 "conclusion": "Fake",
47 "score": "0.9",
48 "certainty": "0.995"
49 }
50 ]
51 }
52 ]
53 }
54 ]
55 },
56 "audio_source_tracing": {
57 "label": "resemble_ai",
58 "error_message": null
59 },
60 "intelligence": {
61 "uuid": "INTELLIGENCE_UUID",
62 "description": "Adult male speaker with confident tone discussing...",
63 "created_at": "2024-01-15T10:30:05Z",
64 "detect_uuid": "DETECTION_UUID"
65 },
66 "url": "https://storage.example.com/audio/suspicious.wav",
67 "audio_url": "https://storage.example.com/audio/suspicious.wav",
68 "filename": "suspicious.wav",
69 "duration": 8.2,
70 "zero_retention_mode": false,
71 "file_deleted_at": null,
72 "created_at": "2024-01-15T10:30:00Z",
73 "updated_at": "2024-01-15T10:30:05Z"
74 }
75}
  • 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 "file_deleted_at": "2024-01-15T10:31:00Z",
19 "created_at": "2024-01-15T10:30:00Z",
20 "updated_at": "2024-01-15T10:30:05Z"
21 }
22}

Error Response (404)

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