GET/v1/cases
List cases
Paginated retrieval of institutional investigation units. Supports high-fidelity filtering by status, priority tiers, and assignee, providing a panoramic view of the institution's investigative workload.
Authentication Protocol
Bearer <API_KEY>Path Parameters
statusstring
Filter by open, investigating, pending_review, etc.
prioritystring
Filter by low, medium, high, or urgent.
owner_idinteger
Filter by assigned officer ID.
pageinteger
Default: 1.
sizeinteger
Default: 20. Max: 100.
Transmission Examples
curl
curl -X GET "https://api.topsafe.ai/api/v1/cases?status=open&priority=urgent" \
-H "Authorization: Bearer YOUR_JWT" \
-H "X-API-Key: YOUR_INSTITUTION_KEY"Schema Response
json
{
"success": true,
"data": [
{
"id": 29,
"case_number": "CASE-DEBN-20260421-00004",
"title": "Suspicious Structuring Pattern",
"priority": "urgent",
"status": "open",
"sla_due_at": "2026-04-22T10:42:00+00:00"
}
],
"pagination": {
"total": 12,
"page": 1,
"size": 20,
"total_pages": 1
}
}