Changelog

Changes to the /v1 contract, newest first. Additive changes ship in place; anything breaking gets a new version path, as described under Versioning.

v1 — initial release

September 2026

The first public version of the Novil API. A TMS or any other system can push dispatch routes into Novil and read back the vehicles, drivers and fuel plans behind them, authenticated with bearer API keys created under Settings › API Keys.

Endpoints:

Method	Path	Summary
GET	/v1/me	Describe the current key
POST	/v1/routes	Create or update a route
GET	/v1/routes	List routes
GET	/v1/routes/{id}	Retrieve a route
DELETE	/v1/routes/{id}	Cancel a route
GET	/v1/vehicles	List vehicles
GET	/v1/drivers	List drivers

Also in this release:

• API keys with the scopes routes:write, routes:read, vehicles:read and drivers:read, in live (nvl_live_) and sandbox (nvl_test_) environments.
• Idempotent route pushes by externalId, superseding by reference, and automatic import of routes held as pending_mapping or pending_window.
• RFC 9457 problem details on every error with a stable code.
• A limit of 600 requests per minute per key, reported through X-RateLimit-Limit, X-RateLimit-Remaining and Retry-After.
• The contract itself, published at /v1/openapi.json.