Analysis Types
When creating a case, you specify an analysis_type to control what analyses run. This determines the processing pipeline, required data, and output included in the final report.
Available Types
| Type | Description | Requires Occupants? | Requires Vehicle Photos? |
|---|---|---|---|
accident_only | Crash analysis with Delta-V and PDOF | No | Yes |
accident_injury | Crash analysis + biomechanics | Yes | Yes |
delta_v_only | Delta-V calculation only | No | Yes |
biomechanics_only | Biomechanics analysis only | Yes | No |
accident_only (Default)
Runs crash reconstruction analysis on vehicle damage photos. Calculates Delta-V, PDOF, and crash pulse timing. Does not include any biomechanics or injury analysis.
Use when: You only need the crash parameters (Delta-V, PDOF) without injury analysis.
curl -X POST "https://api.silentwitness.ai/api/cases" \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"plaintiff_name": "John Smith",
"defendant_name": "Bob Johnson",
"attorney_name": "Jane Attorney",
"analysis_type": "accident_only",
"vehicles": [
{
"role": "plaintiff",
"vehicle_maker": "Toyota",
"vehicle_model": "Camry",
"vehicle_year": "2020",
"vehicle_type": "sedan"
},
{
"role": "defendant",
"vehicle_maker": "Ford",
"vehicle_model": "F-150",
"vehicle_year": "2019",
"vehicle_type": "truck"
}
]
}'
accident_injury
Runs the full pipeline: crash reconstruction followed by biomechanics analysis for each occupant. The technical report includes both crash parameters and injury mechanism analysis.
Use when: You need a complete analysis including how crash forces affected occupants.
Requires: At least one occupant with age, gender, position, and alleged_injuries.
curl -X POST "https://api.silentwitness.ai/api/cases" \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"plaintiff_name": "John Smith",
"defendant_name": "Bob Johnson",
"attorney_name": "Jane Attorney",
"analysis_type": "accident_injury",
"vehicles": [
{
"role": "plaintiff",
"vehicle_maker": "Toyota",
"vehicle_model": "Camry",
"vehicle_year": "2020",
"vehicle_type": "sedan"
}
],
"occupants": [
{
"name": "John Smith",
"age": 45,
"gender": "male",
"height_inches": 70,
"weight_lbs": 180,
"position": "driver",
"seatbelt_worn": true,
"alleged_injuries": ["cervical_spine", "lumbar_spine"],
"injury_severity": "moderate"
}
]
}'
delta_v_only
Runs only the Delta-V calculation from vehicle damage photos. Produces a minimal output focused on the speed change at impact. Skips PDOF analysis and crash pulse timing.
Use when: You only need the Delta-V number for a quick assessment or triage.
curl -X POST "https://api.silentwitness.ai/api/cases" \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"plaintiff_name": "John Smith",
"defendant_name": "Bob Johnson",
"attorney_name": "Jane Attorney",
"analysis_type": "delta_v_only",
"vehicles": [
{
"role": "plaintiff",
"vehicle_maker": "Toyota",
"vehicle_model": "Camry",
"vehicle_year": "2020",
"vehicle_type": "sedan"
}
]
}'
biomechanics_only
Runs only biomechanics analysis for the provided occupants. Does not run crash reconstruction — you must provide crash parameters separately or from a previous analysis.
Use when: You already have crash parameters and only need the injury mechanism analysis.
Requires: At least one occupant with age, gender, position, and alleged_injuries.
curl -X POST "https://api.silentwitness.ai/api/cases" \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"plaintiff_name": "John Smith",
"defendant_name": "Bob Johnson",
"attorney_name": "Jane Attorney",
"analysis_type": "biomechanics_only",
"occupants": [
{
"name": "John Smith",
"age": 45,
"gender": "male",
"height_inches": 70,
"weight_lbs": 180,
"position": "driver",
"seatbelt_worn": true,
"alleged_injuries": ["cervical_spine", "lumbar_spine"],
"injury_severity": "moderate"
}
]
}'
Choosing the Right Type
Do you need injury/biomechanics analysis?
├── No
│ ├── Need full crash parameters? → accident_only
│ └── Just need Delta-V number? → delta_v_only
└── Yes
├── Have vehicle damage photos? → accident_injury (full pipeline)
└── Already have crash params? → biomechanics_only
Next Steps
- Create a Case - Full API reference
- End-to-End Example - Complete workflow walkthrough
- Generating a Report - Report generation guide