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.

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
  }
}

API Pricing

Usage-based pricing that scales with your business.

Starter

$1

/month

  • 100 API calls/month
  • Jobs API (read-only)
  • Hazard Scan (10/month)
  • Webhook events
  • Community support
Get Started
Recommended

Pro

$49

/month

  • 10,000 API calls/month
  • All APIs included
  • Verification API access
  • Fleet & Dispatch APIs
  • Priority email support
  • Webhook retry & logs
Start Pro Trial

Enterprise

Custom

volume pricing

  • Unlimited API calls
  • White-label integration
  • Dedicated account manager
  • Custom SLA (99.9%+)
  • On-prem deployment option
  • SSO & audit logging
Contact Sales

Ready to integrate?

Get your API keys and start building in minutes. Full documentation with request/response examples for every endpoint.