Developer API

Build delivery into your product

The Raute Partner API lets your platform push orders into Raute, pull live driver tracking and ETAs, and subscribe to real-time webhooks. REST + JSON, authenticated with a partner API key. Ideal for POS systems, ecommerce, and delivery marketplaces.

Request API access See live tracking

Authentication

Every request is authenticated with a partner API key sent in the x-api-key header over HTTPS. We issue you a key when your integration is approved. Keys are scoped to your account and rate-limited.

curl https://api.raute.io/v1/orders/ord_9Fk2a.../tracking \
  -H "x-api-key: rt_live_YOUR_PARTNER_KEY"

Base URL: https://api.raute.io · All responses are JSON.

Orders

Push delivery orders into Raute and keep them in sync. Raute geocodes the address, optimizes the route, and assigns a driver.

POST/v1/orders
Available on integration

Create a delivery order.

Request body

{
  "external_id": "ORD-10482",
  "customer_name": "Jane Doe",
  "phone": "+13105550142",
  "address": "123 Main St, Anytown, CA 90210",
  "delivery_date": "2026-07-24",
  "notes": "Gate code 4417"
}

Response

{
  "id": "ord_9Fk2a...",
  "external_id": "ORD-10482",
  "status": "pending",
  "latitude": 34.0522,
  "longitude": -118.2437,
  "geocoding_confidence": "exact",
  "tracking_url": "https://raute.io/track/8f3c...",
  "created_at": "2026-07-23T18:04:11Z"
}
GET/v1/orders
Available on integration

List active orders and their current status.

Response

{
  "data": [
    { "id": "ord_9Fk2a...", "external_id": "ORD-10482",
      "status": "out_for_delivery", "driver": "Alex Rivera",
      "eta_minutes": 12 }
  ],
  "has_more": false
}
GET/v1/orders/{id}
Available on integration

Retrieve one order with its assigned driver and stop sequence.

Response

{
  "id": "ord_9Fk2a...",
  "status": "out_for_delivery",
  "customer_name": "Jane Doe",
  "address": "123 Main St, Anytown, CA 90210",
  "driver": { "name": "Alex Rivera", "phone": "+13105550178" },
  "stop_number": 4,
  "eta_minutes": 12
}
PATCH/v1/orders/{id}
Available on integration

Update or reschedule an order.

Request body

{ "delivery_date": "2026-07-25", "notes": "Leave with front desk" }

Response

{ "id": "ord_9Fk2a...", "status": "pending", "delivery_date": "2026-07-25" }
DELETE/v1/orders/{id}
Available on integration

Cancel an order.

Response

{ "id": "ord_9Fk2a...", "status": "cancelled" }

Live Tracking

Power a branded, real-time tracking experience inside your own app or website: order status, ETA, and the driver's live position. This is the same live driver tracking that runs in the Raute app today, exposed to your account once your integration is set up.

GET/v1/orders/{id}/tracking
Available on integration

Live status, ETA window, and the assigned driver's current position. Driver location is only returned while the order is out for delivery and the fleet has live-location sharing enabled.

Response

{
  "order_id": "ord_9Fk2a...",
  "status": "out_for_delivery",
  "eta_window": "2:10 PM - 2:25 PM",
  "stop_number": 4,
  "driver": {
    "name": "Alex Rivera",
    "lat": 34.0525,
    "lng": -118.2440,
    "updated_at": "2026-07-23T18:22:41Z"
  }
}

Webhooks

Get pushed a real-time event the moment an order changes state, so your app updates instantly instead of polling. The same pattern Raute uses to ingest orders from connected POS systems.

POST/v1/webhooks
Available on integration

Register a URL to receive order events: order.created, order.assigned, order.out_for_delivery, order.delivered, order.cancelled.

Request body

{
  "url": "https://your-app.com/hooks/raute",
  "events": ["order.out_for_delivery", "order.delivered"]
}

Response

// Raute then POSTs this to your URL on each event:
{
  "event": "order.delivered",
  "order_id": "ord_9Fk2a...",
  "external_id": "ORD-10482",
  "delivered_at": "2026-07-23T18:41:02Z",
  "proof_of_delivery_url": "https://raute.io/pod/..."
}

Built for integrations, secured by design

  • • Per-partner API keys, scoped to your account and rate-limited.
  • • A driver’s live location is exposed only while an order is out for delivery, and only when the fleet enables live-location sharing.
  • • All traffic is encrypted with TLS; data is isolated per company with Postgres Row Level Security. See our security overview.
  • • The endpoints above are the partner surface. Internal admin, billing, and fleet-management APIs are never exposed.

Ready to integrate?

Tell us which endpoints your product needs and we’ll issue a sandbox key. Most integrations are live in days, not weeks.

Request API access