Skip to content
Navo24Navo24
GETAPI key

Truck waiting time

GETapi.navo24.com/v1/dd/trucks

Free waiting time and detention rates of hauliers, each row with the source document and the date we read it.

Response schema

20 fields

Derived from the example response, nested as the JSON is.

dataobject[]

The payload. Everything an endpoint returns sits under this key.

data[]object
carrierstring

Carrier name, falling back to the SCAC when we hold no name.

slugstring
countrystring

Country name.

scopestring
free_minutesnumber
ratenumber
currencystring

ISO currency code.

perstring
tiersany | null

Daily charge after free time: from and to are day numbers, rate is per container per day. to null means every day after.

billing_increment_minnumber
minimum_chargenumber
conditionsstring
source_urlstring
source_titlestring
fetchedstring
kindstring

carrier_event when a carrier filed it, trackingmcp_inference when we derived the step from surrounding events.

idstring

Stable identifier for the record. On the tracking endpoints this is the container UUID, except on a portfolio summary row, where it is the container number.

daily_cap_noteany | null
daily_capany | null

Errors

A failure carries { "error": { "code", "message" } } with the HTTP status. Branch on the code, and log the message.

invalid_key401

The key is unknown or revoked.

rate_limited429

More than 60 requests in one minute from one key.

curl 'https://api.navo24.com/v1/dd/trucks' \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY"
Response
{
  "data": [
    {
      "carrier": "Old Dominion Freight Line",
      "slug": "odfl",
      "country": "US",
      "scope": "LTL pickup/delivery – detention, trailer with tractor (ODFL 100-Q Item 502)",
      "free_minutes": 20,
      "rate": 3.0,
      "currency": "USD",
      "per": "1min",
      "tiers": null,
      "billing_increment_min": 1,
      "minimum_charge": 50.0,
      "conditions": "Free time scales with shipments per stop: 1=20, 2=25, 3=30, 4=35, 5=40, 6=45, 7=50, 8=55, 9+=60 min. Quote: 'The charge for the delay of each vehicle beyond the free time will be $3.00 for each following one minute period or fraction thereof, subject to a minimum charge of $50.00 per shipment.' Tariff effective April 14, 2025.",
      "source_url": "https://www.odfl.com/content/dam/odfl/us/en/documents/rates-and-tariffs/Complete%20ODFL%20100-Q%20Tariff.pdf",
      "source_title": "ODFL 100-Q Additional Services and Rules Tariff, Item 502 Detention – Trailer with Tractor",
      "fetched": "2026-10-31",
      "kind": "carrier",
      "id": "odfl-1",
      "daily_cap_note": null,
      "daily_cap": null
    }
  ]
}