Damage Assessment API - Steer Autos Documentation

POST /v1/inspections/damage-assessment

Advanced AI-powered damage assessment that combines visual inspection data with repair cost databases to provide accurate damage severity ratings and repair estimates.

Request

curl -X POST "https://api.steerai.autos/v1/inspections/damage-assessment" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle_id": "veh_1234567890abcdef",
    "inspection_id": "vis_1234567890abcdef",
    "damages": [
      {
        "damage_id": "dmg_front_bumper_001",
        "type": "scratch",
        "location": "front_bumper",
        "severity": "minor"
      },
      {
        "damage_id": "dmg_rear_door_left_002",
        "type": "dent",
        "location": "rear_door_left",
        "severity": "moderate"
      }
    ],
    "assessment_options": {
      "include_repair_timeline": true,
      "include_part_prices": true,
      "labor_rate_region": "US_CALIFORNIA",
      "currency": "USD"
    }
  }'

Request Body

Field	Type	Required	Description
`vehicle_id`	string	Yes	Vehicle identifier
`inspection_id`	string	No	Related visual inspection ID
`damages`	array	Yes	Array of damage objects to assess
`damages[].damage_id`	string	Yes	Unique damage identifier
`damages[].type`	string	Yes	Damage type
`damages[].location`	string	Yes	Vehicle part affected
`damages[].severity`	string	No	Initial severity estimate
`assessment_options.include_repair_timeline`	boolean	No	Include repair time estimates (default: true)
`assessment_options.include_part_prices`	boolean	No	Include OEM/aftermarket part pricing (default: true)
`assessment_options.labor_rate_region`	string	No	Geographic region for labor rates
`assessment_options.currency`	string	No	Currency for pricing (default: USD)

Supported Regions

Region Code	Description	Avg Labor Rate
`US_CALIFORNIA`	California, USA	$150-200/hr
`US_TEXAS`	Texas, USA	$100-150/hr
`US_NORTHEAST`	Northeast USA	$125-175/hr
`US_MIDWEST`	Midwest USA	$90-140/hr
`EU_GERMANY`	Germany	€80-120/hr
`EU_UK`	United Kingdom	£70-100/hr
`EU_FRANCE`	France	€70-100/hr
`ASIA_JAPAN`	Japan	¥8,000-12,000/hr
`ASIA_CHINA`	China	¥400-800/hr

Response

{
  "status": "success",
  "data": {
    "assessment_id": "asmt_1234567890abcdef",
    "vehicle_id": "veh_1234567890abcdef",
    "inspection_id": "vis_1234567890abcdef",
    "created_at": "2024-01-15T12:00:00Z",
    "assessed_damages": [
      {
        "damage_id": "dmg_front_bumper_001",
        "type": "scratch",
        "location": "front_bumper",
        "severity": "minor",
        "severity_score": 2.5,
        "impact_assessment": {
          "structural": "none",
          "cosmetic": "minor",
          "safety": "none",
          "affects_value": true,
          "value_reduction_percentage": 1.2
        },
        "repair_options": [
          {
            "option": "paint_touch_up",
            "description": "Professional paint touch-up and blending",
            "recommended": true,
            "repair_type": "cosmetic",
            "parts_required": [
              {
                "part": "paint_materials",
                "type": "consumable",
                "oem_price": 75,
                "aftermarket_price": 50,
                "currency": "USD"
              }
            ],
            "labor": {
              "hours": 1.5,
              "rate_per_hour": 150,
              "total": 225,
              "currency": "USD"
            },
            "total_cost": {
              "parts": 75,
              "labor": 225,
              "total": 300,
              "currency": "USD"
            },
            "timeline": {
              "estimated_days": 1,
              "description": "Same-day repair possible"
            }
          },
          {
            "option": "bumper_replacement",
            "description": "Complete bumper replacement and paint",
            "recommended": false,
            "repair_type": "replacement",
            "parts_required": [
              {
                "part": "front_bumper_cover",
                "part_number": "52119-12345",
                "type": "body_part",
                "oem_price": 450,
                "aftermarket_price": 250,
                "currency": "USD"
              },
              {
                "part": "paint_and_materials",
                "type": "consumable",
                "oem_price": 200,
                "aftermarket_price": 150,
                "currency": "USD"
              }
            ],
            "labor": {
              "hours": 4.0,
              "rate_per_hour": 150,
              "total": 600,
              "currency": "USD"
            },
            "total_cost": {
              "parts": 650,
              "labor": 600,
              "total": 1250,
              "currency": "USD"
            },
            "timeline": {
              "estimated_days": 3,
              "description": "Includes paint curing time"
            }
          }
        ],
        "recommended_repair": {
          "option": "paint_touch_up",
          "min_cost": 250,
          "max_cost": 350,
          "estimated_cost": 300,
          "currency": "USD"
        }
      },
      {
        "damage_id": "dmg_rear_door_left_002",
        "type": "dent",
        "location": "rear_door_left",
        "severity": "moderate",
        "severity_score": 5.8,
        "impact_assessment": {
          "structural": "minor",
          "cosmetic": "moderate",
          "safety": "none",
          "affects_value": true,
          "value_reduction_percentage": 3.5
        },
        "repair_options": [
          {
            "option": "pdr_and_paint",
            "description": "Paintless dent removal with touch-up",
            "recommended": true,
            "repair_type": "pdr",
            "parts_required": [
              {
                "part": "paint_materials",
                "type": "consumable",
                "oem_price": 150,
                "aftermarket_price": 100,
                "currency": "USD"
              }
            ],
            "labor": {
              "hours": 3.5,
              "rate_per_hour": 150,
              "total": 525,
              "currency": "USD"
            },
            "total_cost": {
              "parts": 150,
              "labor": 525,
              "total": 675,
              "currency": "USD"
            },
            "timeline": {
              "estimated_days": 1,
              "description": "1-day repair typical"
            }
          },
          {
            "option": "panel_replacement",
            "description": "Replace door panel and repaint",
            "recommended": false,
            "repair_type": "replacement",
            "parts_required": [
              {
                "part": "rear_door_shell",
                "part_number": "67003-98765",
                "type": "body_part",
                "oem_price": 850,
                "aftermarket_price": 500,
                "currency": "USD"
              },
              {
                "part": "paint_and_materials",
                "type": "consumable",
                "oem_price": 250,
                "aftermarket_price": 175,
                "currency": "USD"
              }
            ],
            "labor": {
              "hours": 6.5,
              "rate_per_hour": 150,
              "total": 975,
              "currency": "USD"
            },
            "total_cost": {
              "parts": 1100,
              "labor": 975,
              "total": 2075,
              "currency": "USD"
            },
            "timeline": {
              "estimated_days": 5,
              "description": "Includes panel fitting and paint"
            }
          }
        ],
        "recommended_repair": {
          "option": "pdr_and_paint",
          "min_cost": 600,
          "max_cost": 800,
          "estimated_cost": 675,
          "currency": "USD"
        }
      }
    ],
    "summary": {
      "total_damages_assessed": 2,
      "overall_severity": "moderate",
      "overall_severity_score": 4.15,
      "total_value_reduction_percentage": 4.7,
      "repair_cost_summary": {
        "recommended_repairs_total": {
          "min": 850,
          "max": 1150,
          "estimated": 975,
          "currency": "USD"
        },
        "all_repairs_range": {
          "min": 850,
          "max": 3325,
          "currency": "USD"
        }
      },
      "repair_timeline": {
        "estimated_total_days": 2,
        "can_repair_simultaneously": true
      },
      "impact_on_vehicle_value": {
        "estimated_market_value": 25000,
        "value_reduction": 1175,
        "adjusted_value": 23825,
        "currency": "USD"
      }
    },
    "reports": {
      "pdf_url": "https://reports.steerai.autos/asmt_1234567890abcdef.pdf",
      "json_url": "https://api.steerai.autos/v1/inspections/damage-assessment/asmt_1234567890abcdef/report"
    }
  },
  "meta": {
    "request_id": "req_asmt_xyz123",
    "processing_time": 2.456,
    "labor_rate_used": 150,
    "currency": "USD",
    "region": "US_CALIFORNIA"
  }
}

Response Fields

Field	Type	Description
`assessment_id`	string	Unique assessment identifier
`severity_score`	float	Numerical severity (0-10, 10 = total loss)
`impact_assessment.structural`	string	`none`, `minor`, `moderate`, `severe`, `critical`
`impact_assessment.cosmetic`	string	`none`, `minor`, `moderate`, `severe`
`impact_assessment.safety`	string	`none`, `minor`, `moderate`, `severe`, `critical`
`value_reduction_percentage`	float	Percentage reduction in vehicle value
`repair_options[].repair_type`	string	`cosmetic`, `pdr`, `replacement`, `structural`

Severity Scoring

Minor (0-3)

Characteristics: • Surface-level damage only • No structural impact • Cosmetic concerns • Easy and inexpensive to repairExamples: • Light scratches • Small paint chips • Minor scuffs

Moderate (3-6)

Characteristics: • Visible damage affecting appearance • Minor structural concern • Moderate repair complexity • Noticeable value impactExamples: • Dents requiring PDR • Deep scratches through primer • Cracked bumpers • Minor panel misalignment

Severe (6-8)

Characteristics: • Significant damage • Structural integrity affected • Complex repairs required • Major value reductionExamples: • Damaged frame sections • Multiple panel replacement needed • Suspension damage • Major collision damage

Critical (8-10)

Characteristics: • Extensive damage • Safety systems compromised • Potential total loss • Repair cost approaches vehicle valueExamples: • Severe frame damage • Airbag deployment • Flood/fire damage • Multiple system failures

Repair Types

Type	Description	Typical Cost Range	Timeline
Cosmetic	Surface-level repairs, paint work	$100-500	1-2 days
PDR	Paintless dent removal	$200-800	1-2 days
Panel Repair	Body panel repair and refinish	$500-2000	2-5 days
Replacement	Part replacement	$800-5000+	3-7 days
Structural	Frame/structural repairs	$2000-15000+	1-4 weeks

Error Responses

400 Bad Request

{
  "status": "error",
  "error": {
    "code": "INVALID_DAMAGE_DATA",
    "message": "Damage location 'invalid_part' is not recognized",
    "type": "validation_error",
    "field": "damages[0].location"
  }
}

404 Not Found

{
  "status": "error",
  "error": {
    "code": "INSPECTION_NOT_FOUND",
    "message": "The specified inspection_id does not exist",
    "type": "not_found_error",
    "field": "inspection_id"
  }
}

Vehicle Parts Reference

Exterior Panels

• front_bumper • rear_bumper • hood • roof • trunk_lid • front_fender_left • front_fender_right • front_door_left • front_door_right • rear_door_left • rear_door_right • quarter_panel_left • quarter_panel_right

Glass & Lights

• windshield • rear_window • side_window_fl • side_window_fr • side_window_rl • side_window_rr • headlight_left • headlight_right • taillight_left • taillight_right • fog_light_left • fog_light_right

Mechanical

• engine • transmission • suspension_fl • suspension_fr • suspension_rl • suspension_rr • exhaust_system • fuel_system • cooling_system • brake_system

Advanced Features

Cost Optimization: Request both OEM and aftermarket part pricing to provide repair options at different price points. Aftermarket parts can reduce costs by 30-50%.

Integration Example

Combine visual inspection with damage assessment:

import requests

# Step 1: Create visual inspection
visual_response = requests.post(
    "https://api.steerai.autos/v1/inspections/visual",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "vehicle_id": "veh_123",
        "images": [...]
    }
)
visual_id = visual_response.json()["data"]["inspection_id"]

# Step 2: Get detected damages
damages = visual_response.json()["data"]["results"]["damages"]

# Step 3: Assess damages with cost estimates
assessment_response = requests.post(
    "https://api.steerai.autos/v1/inspections/damage-assessment",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "vehicle_id": "veh_123",
        "inspection_id": visual_id,
        "damages": damages,
        "assessment_options": {
            "include_part_prices": True,
            "labor_rate_region": "US_CALIFORNIA"
        }
    }
)

print(f"Total repair cost: ${assessment_response.json()['data']['summary']['repair_cost_summary']['recommended_repairs_total']['estimated']}")

Webhooks

{
  "event": "damage_assessment.completed",
  "timestamp": "2024-01-15T12:00:05Z",
  "data": {
    "assessment_id": "asmt_1234567890abcdef",
    "vehicle_id": "veh_1234567890abcdef",
    "damages_assessed": 2,
    "overall_severity": "moderate",
    "estimated_repair_cost": 975,
    "value_reduction_percentage": 4.7,
    "report_url": "https://reports.steerai.autos/asmt_1234567890abcdef.pdf"
  }
}

Estimate Accuracy: Repair cost estimates are based on regional averages and parts databases. Actual costs may vary by ±20% depending on specific shop rates and parts availability.

API Documentation

​POST /v1/inspections/damage-assessment

​Request

​Request Body

​Supported Regions

​Response

​Response Fields

​Severity Scoring

​Repair Types

​Error Responses

​400 Bad Request

​404 Not Found

​Vehicle Parts Reference

Exterior Panels

Glass & Lights

Mechanical

​Advanced Features

​Integration Example

​Webhooks

POST /v1/inspections/damage-assessment

Request

Request Body

Supported Regions

Response

Response Fields

Severity Scoring

Repair Types

Error Responses

400 Bad Request

404 Not Found

Vehicle Parts Reference

Advanced Features

Integration Example

Webhooks