Developer Documentation

Integrate in 5 Minutes

Three lines of code. That's all it takes to verify work completion with AI.

1Quick Start

bash

curl -X POST https://dispatchiq.ai/api/v1/verify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "job_type": "plumbing",
    "before_photos": ["https://your-bucket.s3.amazonaws.com/before.jpg"],
    "after_photos": ["https://your-bucket.s3.amazonaws.com/after.jpg"]
  }'

2Response Format

Every verification returns a structured JSON object with the verdict, confidence score, and full audit trail.

json

{
  "verification_id": "uuid",           // Unique ID for this verification
  "verdict": "verified",               // verified | rejected | conditional
  "confidence": 88,                    // 0-100 AI confidence score
  "reasoning": "Work verified...",     // Human-readable explanation
  "safety": null,                      // Safety hazard details (if any)
  "providers": [                       // Which AI providers analyzed
    { "provider": "provider_1", "confidence": 90, "model": "..." },
    { "provider": "provider_2", "confidence": 85, "model": "..." }
  ],
  "processing_time_ms": 18500,         // How long analysis took
  "audit_trail_id": "uuid"             // Tamper-proof audit record
}

3API Reference

POST/api/v1/verify

Verify work completion by submitting before/after photos and optional metadata.

Parameter	Type	Required	Description
`job_type`	string	Yes	Trade category (plumbing, hvac, electrical, inspection, insurance_claim, construction, fleet_inspection, environmental)
`before_photos`	string[]	Yes	URLs of before-work photos (max 4)
`after_photos`	string[]	Yes	URLs of after-work photos (max 4)
`job_description`	string	No	Description of the work performed
`video_url`	string	No	URL of completion video (processed async)
`location.lat`	number	No	Capture GPS latitude
`location.lng`	number	No	Capture GPS longitude
`location.job_lat`	number	No	Job site GPS latitude
`location.job_lng`	number	No	Job site GPS longitude
`metadata.client_job_id`	string	No	Your internal job/claim ID
`metadata.client_name`	string	No	Your company name
`metadata.callback_url`	string	No	Webhook URL for video analysis results

GET/api/v1/verify/{id}

Look up a previous verification by its verification_id. Returns the full result including verdict, confidence, providers, and GPS data.

bash

curl https://dispatchiq.ai/api/v1/verify/abc-123-uuid \
  -H "Authorization: Bearer YOUR_API_KEY"

GET/api/v1/verify/status

Check API health, available AI providers, and supported capabilities. Works with or without authentication.

bash

curl https://dispatchiq.ai/api/v1/verify/status \
  -H "Authorization: Bearer YOUR_API_KEY"

4Verdicts Explained

VERIFIED

Work confirmed complete. No safety concerns. Safe to release payment.

CONDITIONAL

Work appears complete but a safety hazard was detected. Requires human review or waiver before payment release.

REJECTED

Work could not be verified from the evidence provided. Photos may be duplicates, unrelated, or show incomplete work.

5Authentication

Include your API key in the Authorization header

Authorization: Bearer YOUR_API_KEY

All endpoints require a valid API key. Requests without authentication return 401 Unauthorized.

Request an API key: api@dispatchiq.ai

6Rate Limits

Starter

1,000

verifications / month

Growth

10,000

verifications / month

Enterprise

Unlimited

verifications / month

Ready to integrate?

Get your API key and start verifying work completion in minutes. Our team will help you get set up.

Get API Key Back to Trust Layer API