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,
  "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 has EDR data 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