List Cases

Returns a list of all cases in your account with their analysis status.

Endpoint

GET /api/cases

Authentication

Requires API Key authentication.

Query Parameters

All parameters are optional.

Parameter	Type	Default	Description
limit	integer	—	Maximum number of cases to return. When omitted, all matching cases are returned.
offset	integer	0	Number of cases to skip (use with limit for pagination).
organization_id	string	—	Filter cases by organization.
status	string	—	Filter by case status (active or archived). When omitted, both active and archived cases are returned (deleted cases are always excluded).

Response

Returns an array of case objects with analysis status.

{
  "success": true,
  "data": [
    {
      "id": "case_abc123def456",
      "name": "Smith v. Johnson",
      "plaintiff_name": "John Smith",
      "defendant_name": "Bob Johnson",
      "attorney_name": "Jane Doe, Esq.",
      "side": "plaintiff",
      "has_edr": false,
      "account_id": "acc_xyz789",
      "organization_id": "org_abc123",
      "status": "active",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z",
      "analysis_status": {
        "accident_reconstruction": {
          "status": "completed"
        },
        "biomechanics_analysis": {
          "status": "none"
        },
        "technical_report": {
          "status": "completed"
        }
      }
    },
    {
      "id": "case_def456ghi789",
      "name": "Williams Case",
      "plaintiff_name": "Jane Williams",
      "defendant_name": "Mike Davis",
      "attorney_name": "Sarah Attorney",
      "side": "plaintiff",
      "has_edr": true,
      "account_id": "acc_xyz789",
      "organization_id": null,
      "status": "active",
      "created_at": "2024-01-10T08:15:00Z",
      "updated_at": "2024-01-12T14:20:00Z",
      "analysis_status": {
        "accident_reconstruction": {
          "status": "processing"
        },
        "biomechanics_analysis": {
          "status": "none"
        },
        "technical_report": {
          "status": "none"
        }
      }
    }
  ]
}

Example

curl -X GET "https://api.silentwitness.ai/api/cases" \
  -H "X-API-Key: $API_KEY"

With Filters

curl -X GET "https://api.silentwitness.ai/api/cases?organization_id=org_abc123&status=active&limit=10" \
  -H "X-API-Key: $API_KEY"

Errors

Code	Description
401	Unauthorized - Invalid or missing API key
500	Internal server error

Error Example

Unauthorized:

{
  "success": false,
  "error": "Unauthorized",
  "error_code": "unauthorized",
  "error_type": "authentication_error",
  "request_id": "req_..."
}