The Case Object

A Case represents a legal case with all associated data including vehicles, occupants, accident information, and generated reports.

Object Structure

{
  "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,
  "has_tcr": true,
  "tcr_file_id": "file_tcr001",
  "tcr": {
    "id": "file_tcr001",
    "name": "TCR_1.pdf",
    "size": 248312,
    "type": "application/pdf",
    "category": "tcr_document",
    "url": "https://storage.silentwitness.ai/...",
    "uploaded_at": "2024-01-15T11:00:00Z"
  },
  "account_id": "acc_xyz789",
  "organization_id": "org_abc123",
  "status": "active",
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T14:45:00Z",

  "accident": {
    "description": "Rear-end collision at red light",
    "date": "2024-01-10",
    "time": "14:30",
    "location": "123 Main St, Los Angeles, CA"
  },

  "vehicles": [
    {
      "id": "veh_abc123",
      "role": "plaintiff",
      "make": "Toyota",
      "model": "Camry",
      "year": "2020",
      "crash_parameters": { ... }
    }
  ],

  "occupants": [
    {
      "id": "occ_abc123",
      "name": "John Smith",
      "age": 45,
      "position": "driver"
    }
  ],

  "report": {
    "id": "rpt_xyz789",
    "status": "completed",
    "pdf_url": "https://..."
  }
}

Attributes

Core Fields

Attribute	Type	Description
id	string	Unique identifier with case_ prefix
name	string	Case name or title (e.g., "Smith v. Johnson")
plaintiff_name	string	Plaintiff name (injured party)
defendant_name	string	Defendant name (at-fault party)
attorney_name	string	Attorney name handling the case
side	string	Which party the attorney represents: plaintiff or defense
has_edr	boolean	Whether any vehicle on the case has an EDR file linked. Computed live from the vehicles — not a cached value.
has_tcr	boolean	Whether the case has a Traffic Collision Report (TCR) uploaded.
tcr_file_id	string | null	ID of the most-recently-uploaded TCR file, or null if none. Virtual field derived from the files table — upload a file with file_category=tcr_document to set it.
tcr	object | null	Expanded TCR file object (id, name, size, type, category, url, uploaded_at). null if no TCR is uploaded.
account_id	string	Account that owns this case
organization_id	string	Organization associated with the case (optional)
status	string	Case status: active, archived, deleted
created_at	string	ISO 8601 timestamp of creation
updated_at	string	ISO 8601 timestamp of last update

Nested Objects

Attribute	Type	Description
accident	object	Accident information (see below)
vehicles	array	List of Vehicle objects
occupants	array	List of Occupant objects
report	object	Latest Report summary (null if none)

Accident Object

Attribute	Type	Description
description	string	Detailed narrative of the accident
date	string	Date of accident in YYYY-MM-DD format
time	string	Time of accident in HH:MM format
location	string	Address or description of accident location

Related Endpoints

• Create Case - Create a new case
• Get Case - Retrieve a case by ID
• Update Case - Update case data
• List Cases - List all cases