Changelog

Changes to the public /v1 API are versioned and additive where possible. Adding an endpoint, field, scope, error code, or webhook event type is a non-breaking change; removing or renaming one is not, and would ship under a new API version. Subscribe to fleet.provisioned and watch this page for updates.

#2026-07-01 — v1 launch

The first public release of the FuelAtlas Public API.

• Fleets & vehicles — provision fleets (partner keys) and manage vehicles, addressable by your own external_ref.
• Location ingestion — POST /v1/locations batch push (up to 500 items / 1 MB) with independent per-item results.
• Autoguide — continuous, per-vehicle fuel-stop recommendations with phases and data-freshness grading.
• Routes & stations — one-shot route + fuel-plan optimize, and station/price queries (nearby and along a corridor).
• Trips — dispatch-trip lifecycle with stop arrival/departure and progress.
• Fuelings & savings — record fuelings and roll up fleet savings with an adherence rate.
• Webhooks — 13 event types, HMAC-SHA256 signatures, retries, replay, and dual-valid secret rotation.
• Sandbox — a fully simulated fleet driven by fa_test_ keys, with scenarios and reset.
• RFC 9457 errors — a stable problem+json envelope and a documented error-code registry.
• Discovery — anonymous OpenAPI at /v1/openapi.json, llms.txt / llms-full.txt, and an MCP server.