Skip to content
novilDevelopers
Open Novil
Novil API · v1

Connect your TMS to Novil.

A small REST API for pushing dispatch routes into Novil and reading back the vehicles, drivers and fuel plans they produce. Authenticate with a key from Settings › API Keys.

Read the quickstartGet an API key
TerminalPush a load, get a route
$ curl https://app.novilfleet.com/v1/routes \
    -H "Authorization: Bearer $NOVIL_API_KEY" \
    -H "Content-Type: application/json" \
    -d @load-23787.json

{
  "id": "9d1e3d0c-1b7a-4e0a-8a55-7b7c2b0e1f6d",
  "externalId": "ord_88213",
  "name": "Load 23787",
  "status": "draft",
  "vehicle": { "unitNumber": "4471" },
  "driver": { "name": "Dana Whitfield" }
}
Authentication

Bearer keys with scopes. Live keys write to your fleet; sandbox keys write to a copy you can test against.

Read the guide →Push your first route

One POST creates a draft route. Novil plans the fuel stops when the truck reaches the first stop and sends them to the driver.

Read the guide →Match vehicles and drivers

How unit numbers and names resolve, and what to do when a route comes back as pending_mapping.

Read the guide →

Endpoints

Full reference →