Findings
Get a finding
GET
/api/v1alpha1/findings/{finding_id}Returns one finding together with all of its evidence.
- Access: an alpha-enabled API key with the
VIEW_INSIGHTSpermission. - Response: keeps
result_state, the rule the finding came from, any limitations recorded inmetadata, and the review fields when they are set. - Evidence: may include a clip URL, a thumbnail URL, a transcript span, an OCR span, or a scene description.
- Not found: a finding in another workspace is deliberately indistinguishable from one that does not exist.
Use the evidence to check the claim before you accept, dismiss or escalate it in your own product.
Authorization
apiKey AuthorizationBearer <token>
In: header
Path Parameters
finding_id*string
Identifier of a finding, as returned in data[].id by GET /api/v1alpha1/findings.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/api/v1alpha1/findings/finding_0190b5d4-7e1f-7a2b-9c3d-1234567890ab" \ -H "Authorization: Bearer $DEEPFRAME_API_KEY"{ "created_at": "2026-08-08T10:05:00.000Z", "description": "A person entered the restricted area without a visible authorization badge.", "evidence": [ { "clip_url": "https://cdn.example.test/media/vid_0190b5d4/clip-42.mp4", "end_time": 49.75, "finding_id": "finding_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "id": "evidence_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "start_time": 42.25, "video_id": "vid_0190b5d4-7e1f-7a2b-9c3d-1234567890ab" } ], "evidence_ids": [ "evidence_0190b5d4-7e1f-7a2b-9c3d-1234567890ab" ], "id": "finding_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "metadata": { "extraction_method": "", "frame_number": 0, "limitations": [ "" ], "quality": "" }, "result_state": "uncertain", "reviewed_at": "2026-08-08T10:08:45.000Z", "reviewed_by": "user_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "rule_id": "rule_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "rule_reference": "SEC-04", "run_id": "run_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "severity": "high", "status": "open", "title": "Restricted area entry detected", "type": "restricted_area_entry", "updated_at": "2026-08-08T10:08:45.000Z", "video_id": "vid_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "workflow_id": "wf_0190b5d4-7e1f-7a2b-9c3d-1234567890ab"}