API Platform

Build on DispatchIQ.

Integrate AI-powered dispatch, hazard scanning, work verification, and payment processing into your own applications with our REST API. Full programmatic access to every feature on the platform.

Request API Access View Examples

RESTful JSON · Bearer token auth · Webhook events · Rate limited · SDKs coming soon

API Capabilities

Everything you need to build on our platform.

🔧

POST /api/jobs

Jobs API

Full CRUD lifecycle for service jobs. Create, update, assign, and track jobs with filtering, pagination, and real-time status transitions.

🎯

POST /api/dispatch/match

Dispatch API

Tap into our 5-factor merit scoring algorithm. Match and route the best available technician based on distance, skills, ratings, speed, and fix rate.

📸

POST /api/scan/analyze

Hazard Scan API

Submit photos and receive structured hazard reports with severity levels, confidence scores, and building code citations. Powered by fine-tuned AI models.

🛡️

POST /api/verify

Verification API

Multi-provider AI work verification with before/after photo comparison. Consensus-based confidence scoring across Gemini, Claude, and OpenAI.

🚚

GET /api/fleet/vehicles

Fleet API

Manage fleet drivers, vehicles, shifts, and rides. Dispatch transit, track GPS pings, and coordinate hotshot deliveries and debris extraction.

🔔

POST /api/webhooks/register

Webhooks

Real-time event notifications for job status changes, payment completions, verification results, dispatch updates, and hazard scan completions.

Quick Start Examples

Get up and running in minutes. Real endpoints, real response shapes.

1. Create a Job

POST /api/jobs

curl

curl -X POST https://api.dispatchiq.com/v1/jobs \
  -H "Authorization: Bearer diq_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Kitchen faucet replacement",
    "category": "plumbing",
    "description": "Leaking kitchen faucet, need full replacement",
    "address": "123 Main St, Troy, MI 48084",
    "urgency": "standard",
    "photos": ["https://storage.dispatchiq.com/uploads/before-1.jpg"]
  }'

# Response 201 Created
{
  "id": "job_7f2a9c3e",
  "status": "pending",
  "category": "plumbing",
  "urgency": "standard",
  "estimated_price": 18500,
  "title": "Kitchen faucet replacement",
  "created_at": "2025-01-15T10:30:00Z"
}

2. Run a Hazard Scan

POST /api/scan/analyze

curl

curl -X POST https://api.dispatchiq.com/v1/scan/analyze \
  -H "Authorization: Bearer diq_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "image": "<base64-encoded-image>",
    "image_type": "image/jpeg",
    "zip_code": "48084",
    "scan_type": "homeowner"
  }'

# Response 200 OK
{
  "safe": false,
  "hazard_count": 2,
  "critical_count": 1,
  "warning_count": 1,
  "summary": "Found 2 hazard(s): 1 critical, 1 warning(s).",
  "hazards": [
    {
      "risk_type": "electrical",
      "severity": "critical",
      "description": "Exposed wiring near water source in kitchen area",
      "confidence": 0.94,
      "citation": "NEC 210.8(A)(7)"
    },
    {
      "risk_type": "mold",
      "severity": "medium",
      "description": "Visible dark discoloration on ceiling drywall consistent with moisture damage",
      "confidence": 0.82,
      "citation": "EPA Mold Guidelines Section 4"
    }
  ],
  "processing_ms": 3420
}

3. Register a Webhook

POST /api/webhooks/register

curl + webhook payload

curl -X POST https://api.dispatchiq.com/v1/webhooks/register \
  -H "Authorization: Bearer diq_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/hooks/dispatchiq",
    "events": ["job.verified", "job.completed", "payment.released"],
    "secret": "whsec_your_signing_secret"
  }'

# Webhook payload delivered to your endpoint:
{
  "event": "job.verified",
  "timestamp": "2025-01-15T14:30:00Z",
  "data": {
    "job_id": "job_7f2a9c3e",
    "verification": {
      "status": "passed",
      "confidence": 0.94,
      "providers_agree": 3,
      "providers_total": 3,
      "consensus": "unanimous"
    },
    "escrow_action": "release",
    "tech_payout_cents": 15725
  }
}