Detect exterior damage

POST /v1/damage/detect accepts 1 to 30 exterior photos of the same vehicle. Send photos in chronological order. CarHub preserves that order and charges one image unit for each processed photo. The endpoint is in invite-only beta. Your organisation needs explicit access.

Send files directly

Repeat the images multipart field in the required order.

curl -sS "$CARHUB_API_URL/v1/damage/detect?wait=true" \
  -H "Authorization: Bearer $CARHUB_API_KEY" \
  -F "images=@front-left.jpg" \
  -F "images=@left-side.jpg" \
  -F "mask_format=polygon" \
  -F "attribute_parts=true" \
  -F "min_confidence=0.85"

Use uploaded files

Upload large files first. Then submit their references in order.

curl -sS "$CARHUB_API_URL/v1/damage/detect" \
  -H "Authorization: Bearer $CARHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input_refs": ["upl_first", "upl_second"],
    "mask_format": "polygon",
    "attribute_parts": true,
    "min_confidence": 0.85
  }'

The response is a job. A synchronous request returns 200 when inference completes within the wait budget. Otherwise it returns 202 and continues processing.

Poll the job

Read the job URL from the Location response header, or use its id.

curl -sS "$CARHUB_API_URL/v1/jobs/$JOB_ID" \
  -H "Authorization: Bearer $CARHUB_API_KEY"

Each item in damages represents one associated damage. Its geometry comes from the highest-confidence observation. Use observations for frame-specific geometry, masks, confidence and part attribution. Damage IDs remain stable only within that job.

Start here

Integration guides

SDK

API reference

Send files directly

Use uploaded files

Poll the job

​Send files directly

​Use uploaded files

​Poll the job

Send files directly

Use uploaded files

Poll the job