The Vehicle Object

A Vehicle represents a vehicle involved in an accident. Vehicles are nested within a Case and can have associated crash parameters computed from damage analysis.

Object Structure

{
  "id": "veh_abc123",
  "role": "plaintiff",
  "make": "Toyota",
  "model": "Camry",
  "year": "2020",
  "vin": "4T1B11HK5LU123456",
  "type": "sedan",
  "edr_file_id": null,
  "image_file_ids": ["file_img1", "file_img2", "file_img3"],
  "files": [
    {
      "id": "file_img1",
      "name": "front_damage.jpg",
      "size": 245000,
      "type": "image/jpeg",
      "category": "crash_analysis_plaintiff",
      "url": "https://storage.silentwitness.ai/...",
      "uploaded_at": "2024-01-15T10:35:00Z"
    }
  ],
  "crash_parameters": {
    "delta_v_min": 8.5,
    "delta_v_max": 12.3,
    "delta_v_method": "ml",
    "pdof_degrees": 180,
    "crash_pulse_min_ms": 12,
    "crash_pulse_max_ms": 100,
    "calculated_at": "2024-01-15T12:00:00Z"
  }
}

Attributes

Core Fields

Attribute	Type	Description
id	string	Unique identifier with veh_ prefix
role	string	Vehicle role: plaintiff or defendant
make	string	Manufacturer (e.g., "Toyota", "Ford")
model	string	Model name (e.g., "Camry", "F-150")
year	string	Model year (e.g., "2020")
vin	string	Vehicle Identification Number (17 characters)
type	string	Vehicle type: sedan, suv, truck, van, motorcycle, other

File References

Attribute	Type	Description
edr_file_id	string	File ID of uploaded EDR data (null if not uploaded)
image_file_ids	array	Array of file IDs for uploaded damage photos
files	array	Full file objects with metadata and URLs (for display)

File Object

Attribute	Type	Description
id	string	File identifier
name	string	Original filename
size	integer	File size in bytes
type	string	MIME type (e.g., "image/jpeg")
category	string	File category (e.g., "crash_analysis_plaintiff")
url	string	Signed URL for file access
uploaded_at	string	ISO 8601 upload timestamp

Crash Parameters

Attribute	Type	Description
crash_parameters	object	Computed crash analysis data (null until calculated)

See Crash Parameters for the full object structure.

Vehicle Types

Value	Description
sedan	Standard passenger car
suv	Sport utility vehicle
truck	Pickup truck
van	Minivan or cargo van
motorcycle	Motorcycle
other	Other vehicle type

Related Endpoints

• Create Case - Create vehicles with case
• Update Case - Link files to vehicles
• Get Case - Retrieve vehicles with crash parameters