Developer Platform

Roll-Off Optimization as an API

Stop building dispatch logic from scratch. Klau's API gives you battle-tested optimization, container chaining, and real-time events—so you can focus on your product.

Request API Access View API Docs

Quick Start

Ship in minutes, not months

Our REST API is designed for developers who value clarity. Real endpoints. Real responses. No surprises.

Optimize dispatch in one call

Send your jobs, drivers, and trucks. Get back optimized assignments with container chaining, time window compliance, and truck compatibility—all handled for you.

optimize.js

// Optimize a day's dispatch with one API call
const response = await fetch('https://api.getklau.com/v1/optimize', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer kl_live_xxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '2025-12-20',
    constraints: {
      respectTimeWindows: true,
      prioritizeChainContinuity: true,
    }
  })
});

const { data } = await response.json();
// data.assignments: optimized job-to-driver assignments
// data.metrics: { chainScore: 87, milesReduced: 45, ... }

Real-time webhooks

Subscribe to events and get instant notifications. Job completed? Driver started break? Route re-optimized? You'll know immediately.

webhook-payload.json

// Webhook payload for job completion
{
  "event": "job.completed",
  "version": "2025-12-01",
  "data": {
    "jobId": "job_abc123",
    "driverId": "drv_xyz789",
    "completedAt": "2025-12-20T14:32:00Z",
    "location": {
      "lat": 35.6284,
      "lng": -120.6951
    },
    "containerSize": 30,
    "dumpWeight": 4.2,
    "nextJob": {
      "id": "job_def456",
      "type": "DELIVERY",
      "eta": "2025-12-20T15:15:00Z"
    }
  }
}

Platform Features

Everything you need to integrate

We handle the hard parts so you can focus on building great products for haulers.

Optimization Engine

Container chaining, truck compatibility, dump site hours, time windows—all the roll-off-specific logic, ready to use.

Webhooks with Guaranteed Delivery

24-hour retry with exponential backoff. If your endpoint is down, we queue events until you're back.

Security First

API keys are hashed at rest. Rate limiting per-developer, per-tenant, per-endpoint. Your data stays yours.

OpenAPI 3.1 Spec

Auto-generated from code. Always accurate. Generate clients in any language—TypeScript, Python, Go, C#.

Idempotency Support

Safe retries on network failures. Pass an idempotency key, and we handle the rest.

Multi-Tenant Ready

Building for multiple haulers? Our tenant isolation ensures data never leaks between customers.

Response Format

Predictable, typed responses

Every response follows the same structure. Full TypeScript types available. No guessing what the API returns.

Chain attribution
See exactly which jobs were chained together and why
Metrics included
Miles saved, yard returns avoided, chain scores—built in
Sub-second optimization
Average response time under 1 second for typical fleet sizes

optimization-response.json

{
  "data": {
    "optimizationId": "opt_2025-12-20_abc123",
    "status": "completed",
    "executionTimeMs": 847,
    "assignments": [
      {
        "driverId": "drv_marcus",
        "truckId": "truck_12",
        "jobs": [
          {
            "id": "job_001",
            "type": "PICKUP",
            "containerSize": 30,
            "eta": "2025-12-20T08:30:00Z",
            "sequence": 1
          },
          {
            "id": "job_002",
            "type": "DUMP",
            "eta": "2025-12-20T09:15:00Z",
            "sequence": 2
          },
          {
            "id": "job_003",
            "type": "DELIVERY",
            "containerSize": 30,
            "eta": "2025-12-20T10:00:00Z",
            "sequence": 3,
            "chainedFrom": "job_001"  // Same container, no yard return!
          }
        ],
        "metrics": {
          "totalMiles": 47.3,
          "estimatedHours": 6.2,
          "chainScore": 92
        }
      }
    ],
    "summary": {
      "totalJobs": 24,
      "totalDrivers": 4,
      "avgChainScore": 87,
      "milesReduced": 45,
      "yardReturnsAvoided": 8
    }
  }
}

For Your Leadership

The pitch deck you didn't have to write

We know you need to justify this to someone. Here's the ROI story.

6-12 mo

Time saved vs building optimization in-house

API access included in Klau subscription

15-25%

Typical efficiency gain from container chaining

Build vs. Buy

Building In-House

• 6-12 months development time
• Dedicated optimization team (2-3 engineers)
• Ongoing maintenance and edge cases
• Roll-off domain expertise required

Using Klau API

• Integration in days, not months
• Battle-tested by real haulers
• We handle the edge cases
• Continuous improvement included

Ready to integrate?

API access is included with every Klau subscription. No separate developer tier. No usage fees. Just powerful optimization at your fingertips.

Request API Access Read the Developer Story