{"openapi":"3.1.0","info":{"title":"Haul10 API","version":"1.0.0","description":"Whether a US motor carrier is current, from FMCSA open data: USDOT status, operating authority, liability insurance, MCS-150 schedule, UCR bracket and fee. Read-only. Keyless requests are limited to 30 an hour per IP on the status route; a free API key (Authorization: Bearer cd_live_...) gets 200 calls a day, and 5000 a day once the account has a Pro carrier (Standard $149 a year, Fleet $449 a year). Errors are JSON with a sentence in \"error\" and a stable \"code\". Haul10 is a private company, not a government site."},"servers":[{"url":"https://www.haul10.com/api"}],"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"An API key from Settings, beginning h10_live_."}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}},"required":["error"]}}},"paths":{"/v1/carriers/{usdot}/status":{"get":{"summary":"Filing status of a carrier","description":"Reads FMCSA's Company Census and Motus Carrier files for the USDOT number and returns the carrier's status, authority, insurance, MCS-150 schedule and state, UCR bracket and fee, and a `signals` object for onboarding checks. UCR payment is not in public data and is reported as such.","parameters":[{"name":"usdot","in":"path","required":true,"schema":{"type":"string","pattern":"^[0-9]{1,8}$"},"description":"USDOT number, digits only"}],"security":[{},{"apiKey":[]}],"responses":{"200":{"description":"Status","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Not a valid USDOT number (code invalid)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not in FMCSA's census (code not_found)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited (code rate_limited)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"FMCSA's open-data service didn't answer (code unavailable). Safe to retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/ucr/fee":{"get":{"summary":"UCR bracket and fee","parameters":[{"name":"vehicles","in":"query","required":true,"schema":{"type":"integer","minimum":0}},{"name":"year","in":"query","schema":{"type":"integer","enum":[2026,2027]}},{"name":"entity","in":"query","schema":{"type":"string","enum":["carrier","broker_leasing"]}}],"responses":{"200":{"description":"Fee","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No table for that year","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/me/carriers":{"get":{"summary":"Carriers tracked by the key's account, and what is due","security":[{"apiKey":[]}],"responses":{"200":{"description":"Carriers","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Missing or invalid key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}