List Files

Returns a list of all files associated with a case.

Endpoint

GET /api/files

Authentication

Requires API Key authentication.

Query Parameters

Parameter	Type	Required	Description
case_id	string	Yes	Case ID to list files for

Response

Returns an object containing a files array, a count, and maxFiles (the configured upload limit).

{
  "success": true,
  "data": {
    "files": [
      {
        "id": "file_abc123def456",
        "case_id": "case_xyz789",
        "file_name": "front_damage.jpg",
        "file_size": 2456789,
        "file_type": "image/jpeg",
        "status": "ready",
        "file_source": "plaintiff",
        "file_category": "vehicle_photo",
        "vehicle_index": 0,
        "created_at": "2024-01-15T10:30:00Z",
        "updated_at": "2024-01-15T10:31:00Z"
      }
    ],
    "count": 1,
    "maxFiles": 50
  }
}

Example

curl -X GET "https://api.silentwitness.ai/api/files?case_id=case_abc123def456" \
  -H "X-API-Key: $API_KEY"

Response Fields

Field	Type	Description
id	string	Unique file identifier
case_id	string	Case this file belongs to
file_name	string	Original file name
file_size	integer	File size in bytes
file_type	string	MIME type (e.g., image/jpeg)
status	string	File status: processing, ready, error
file_source	string	Source: plaintiff, defense
file_category	string	Category for workflow organization
vehicle_index	integer	Vehicle index (0=plaintiff, 1=defendant)
created_at	datetime	When the file was uploaded
updated_at	datetime	When the file was last updated

Errors

Code	Description
400	Missing case_id parameter
401	Unauthorized - Invalid or missing token
500	Internal server error