# OwnRoute
> Vehicle routing optimization API for autonomous agents and software clients. Built on VROOM + OSRM. Multi-tenant, bearer-token auth.

## What it does
Given N delivery jobs and M drivers, returns ordered routes per driver with ETAs in <1s for 100s of jobs.

## Audiences
- /          - Operators (humans running fleets)
- /developers - Engineers integrating dispatch into a product
- /agents    - Autonomous agents and AI clients (this is the page LLMs should read first)

## Primary endpoint
- POST https://api.ownroute.org/api/v1/optimize - assigns jobs to drivers, returns routes
- POST https://api.ownroute.org/api/v1/jobs - create a delivery job
- POST https://api.ownroute.org/api/v1/drivers - register a driver
- GET  https://api.ownroute.org/api/v1/jobs - list jobs

## Auth
- Header: `Authorization: Bearer ork_live_...`
- Get a key: https://ownroute.org/signup?plan=agent (prepay $1+ via card, USDC on Base, or OWN credits)

## Pricing for agents
- $0.001 per optimize call
- $0.0001 per write
- Reads are free
- 5% rebate as OWN credits on every dollar spent

## Stability contract
- Path-versioned: /api/v1/* will not break.
- Deprecations: 90 days notice via `Deprecation:` response header.
- Webhooks: HMAC-SHA256 signed.

## Rate limits
- 60 requests/minute/key by default. Bursts up to 240.
- Optimize: max 1000 jobs and 200 drivers per call.

## Manifests
- OpenAPI 3.1: https://ownroute.org/.well-known/openapi.json
- MCP: https://ownroute.org/.well-known/mcp.json
- Plugin: https://ownroute.org/.well-known/ai-plugin.json
- Status: https://status.ownroute.org