Skip to main content

​
POST /v1/inspections

Create a new vehicle inspection by submitting vehicle details and images.

​
Request

curl -X POST "https://api.steerai.autos/v1/inspections" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vehicle": {
      "vin": "1HGBH41JXMN109186",
      "make": "Honda",
      "model": "Civic",
      "year": 2021,
      "mileage": 45000
    },
    "inspection_type": "full",
    "images": [
      "https://your-storage.com/front.jpg",
      "https://your-storage.com/rear.jpg",
      "https://your-storage.com/left.jpg",
      "https://your-storage.com/right.jpg"
    ]
  }'

​
Request Body

FieldTypeRequiredDescription
vehicle.vinstringYesVehicle Identification Number
vehicle.makestringYesVehicle manufacturer
vehicle.modelstringYesVehicle model
vehicle.yearintegerYesManufacturing year
vehicle.mileageintegerNoCurrent mileage
inspection_typestringYesType: basic, standard, or full
imagesarrayYesArray of image URLs (min 4, max 50)

​
Response

{
  "status": "success",
  "data": {
    "inspection_id": "insp_1234567890abcdef",
    "vehicle_id": "veh_abcdef1234567890",
    "status": "processing",
    "created_at": "2024-01-15T10:30:00Z",
    "estimated_completion": "2024-01-15T10:31:00Z"
  },
  "meta": {
    "request_id": "req_9876543210fedcba",
    "processing_time": 0.234
  }
}

​
Response Fields

FieldTypeDescription
inspection_idstringUnique inspection identifier
vehicle_idstringUnique vehicle identifier
statusstringCurrent status: processing, completed, failed
created_atstringISO 8601 timestamp
estimated_completionstringExpected completion time

​
Error Responses

​
400 Bad Request

{
  "status": "error",
  "error": {
    "code": "INVALID_VIN",
    "message": "The provided VIN is invalid",
    "type": "validation_error",
    "field": "vehicle.vin"
  }
}

​
429 Rate Limit Exceeded

{
  "status": "error",
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Try again in 60 seconds",
    "type": "rate_limit_error",
    "retry_after": 60
  }
}

​
Webhook Notification

When inspection completes, you’ll receive a webhook notification: 
{
  "event": "inspection.completed",
  "data": {
    "inspection_id": "insp_1234567890abcdef",
    "status": "completed",
    "damages_detected": 3,
    "overall_condition": "fair",
    "report_url": "https://reports.steerai.autos/insp_1234567890abcdef"
  }
}