List findings
/api/v1alpha1/findingsReturns the findings in your workspace, newest first, each with its evidence attached.
- Access: an alpha-enabled API key with the
VIEW_INSIGHTSpermission. - Filters:
run_id,video_id,result_state. - Paging:
limitdefaults to 25, maximum 100. Passnext_cursorback unchanged ascursor. - Result states:
found,not_found,uncertainandnot_checkedare kept as they are, so an uncertain check is never reported as a pass.
Once a run has findings, call this with its run_id, then open the evidence URLs or fetch a single finding with GET /api/v1alpha1/findings/{finding_id}.
Authorization
apiKey In: header
Query Parameters
Opaque cursor returned as next_cursor by the previous response. Pass it byte-for-byte as cursor; do not decode, edit, or construct it.
Number of resources to return in one page. The default is 25 and the accepted range is 1-100.
int321 <= value <= 10025Return only findings associated with this analysis-run identifier.
Return only findings associated with this video identifier.
Trust state for a claim or answer:
- found: the requested condition is supported by the available evidence.
- not_found: the requested condition is not supported by the available evidence.
- uncertain: the evidence is insufficient or conflicting.
- not_checked: the system did not inspect the required evidence. Use this field to filter findings by result state.
Value in
- "found"
- "not_found"
- "uncertain"
- "not_checked"
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" \ -H "Authorization: Bearer $DEEPFRAME_API_KEY"{ "data": [ { "created_at": "2026-08-08T10:05:00.000Z", "description": "A person entered the restricted area without a visible authorization badge.", "evidence": [], "evidence_ids": [ "evidence_0190b5d4-7e1f-7a2b-9c3d-1234567890ab" ], "id": "finding_0190b5d4-7e1f-7a2b-9c3d-1234567890ab", "result_state": "uncertain", "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", "workflow_id": "wf_0190b5d4-7e1f-7a2b-9c3d-1234567890ab" } ], "has_more": false, "next_cursor": "MDEyMzQ1Njc4OWFitSLKnTQIcJAwDPi07V5EGs76Im3F8rCuUshrBnHuUJY7_8Ie8Stea_TKuhKhDw5XkRdkBI3IKkvsKT9Kp60Wpx7CoTCGQW8FnalDILVbuy8wxvWWf_B8SA"}