Skip to main content

Inspection Links

An inspection link is a hosted capture URL. You create an inspection, send the returned link to a customer, and they complete the guided walkthrough in the browser — no app install, no frontend work on your side.

curl https://api.gauzr.com/v1/inspections \
-H "Authorization: Bearer $GAUZR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"reference": "claim_84213",
"vehicle": { "vin": "1HGCM82633A004352" },
"notify_url": "https://your-app.com/webhooks/gauzr",
"expires_in": 86400
}'

The response includes capture_url — the link to hand to the customer.

FieldTypeDescription
referencestringYour own identifier, echoed back on every event.
vehicle.vinstringOptional. Pre-fills VIN so the customer only confirms it.
notify_urlstringWhere webhooks for this inspection are delivered.
expires_inintegerSeconds until the link expires. Defaults to 24h.

What the customer sees

The walkthrough guides capture step by step:

  • Angle prompts position each shot so panels are usable as evidence.
  • Lighting checks flag glare or low light before a photo is accepted.
  • VIN capture confirms the vehicle identity.

Because capture runs in the browser, it works on any modern phone. Evidence is buffered so a dropped signal mid-walkthrough doesn't lose progress.

StatusMeaning
createdLink issued, not yet opened.
in_progressCustomer is capturing.
processingWalkthrough submitted; detection and grading running.
completedReport ready.
expiredLink passed expires_in before submission.

Subscribe to these transitions with Webhooks, or poll the inspection via the API Reference.