{"openapi":"3.1.0","info":{"title":"FennecMesh","description":"The freight data API for engineers and AI agents. One normalized API for ELDs, TMS platforms and insurers. Entity reads accept ?include_raw=true to also return the provider's own payload in an opaque `raw` field ({ provider, fetched_at, payload }) — provider-specific, no stability guarantee.","version":"1.0.0"},"servers":[{"url":"/","description":"Current deployment"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-Api-Key"}}},"security":[{"ApiKeyAuth":[]}],"paths":{"/v1/overview":{"get":{"summary":"Fleet KPIs across every connected carrier","tags":["Telematics"],"responses":{"200":{"description":"Overview metrics"}}}},"/v1/vehicles":{"get":{"summary":"Every vehicle across all connected ELDs","tags":["Telematics"],"parameters":[{"name":"connection_id","in":"query","schema":{"type":"string"}},{"name":"include_raw","in":"query","schema":{"type":"boolean","default":false},"description":"Attach the provider's own payload per vehicle"}],"responses":{"200":{"description":"Vehicle list"}}}},"/v1/vehicles/{id}":{"get":{"summary":"One vehicle with driver, duty status, and latest position","tags":["Telematics"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"include_raw","in":"query","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Vehicle detail"}}}},"/v1/vehicles/{id}/locations":{"get":{"summary":"Breadcrumb history with derived stops","tags":["Telematics"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"start","in":"query","schema":{"type":"string"}},{"name":"end","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","maximum":20000}},{"name":"include_raw","in":"query","schema":{"type":"boolean","default":false},"description":"Attach the provider's ping history payload covering the window"}],"responses":{"200":{"description":"Location history"}}}},"/v1/locations/latest":{"get":{"summary":"Latest position for every vehicle","tags":["Telematics"],"parameters":[{"name":"include_raw","in":"query","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Latest positions"}}}},"/v1/drivers":{"get":{"summary":"Drivers with HOS clocks (FMCSA rules)","tags":["Telematics"],"parameters":[{"name":"connection_id","in":"query","schema":{"type":"string"}},{"name":"include_raw","in":"query","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Driver list"}}}},"/v1/drivers/{id}/hos":{"get":{"summary":"8-day duty log with clocks and violations","tags":["Telematics"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"include_raw","in":"query","schema":{"type":"boolean","default":false},"description":"Attach the provider's duty-log payload covering the window"}],"responses":{"200":{"description":"HOS detail"}}}},"/v1/hos/violations":{"get":{"summary":"Drivers currently in violation","tags":["Telematics"],"parameters":[{"name":"include_raw","in":"query","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Violation list"}}}},"/v1/inspections":{"get":{"summary":"DVIR inspections with defects","tags":["Telematics"],"parameters":[{"name":"status","in":"query","schema":{"type":"string"}},{"name":"vehicle_id","in":"query","schema":{"type":"string"}},{"name":"connection_id","in":"query","schema":{"type":"string"}},{"name":"days","in":"query","schema":{"type":"integer"}},{"name":"include_raw","in":"query","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Inspection list"}}}},"/v1/inspections/{id}":{"get":{"summary":"One inspection with its full defect list","tags":["Telematics"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"include_raw","in":"query","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Inspection detail"}}}},"/v1/tms/loads":{"get":{"summary":"Loads from every connected TMS","tags":["TMS"],"parameters":[{"name":"status","in":"query","schema":{"type":"string"}},{"name":"connection_id","in":"query","schema":{"type":"string"}},{"name":"q","in":"query","schema":{"type":"string"}},{"name":"include_raw","in":"query","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Load list"}}}},"/v1/tms/loads/{id}":{"get":{"summary":"One load with stops and live tracking","tags":["TMS"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"include_raw","in":"query","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Load detail with tracking"}}}},"/v1/tms/summary":{"get":{"summary":"TMS KPIs","tags":["TMS"],"responses":{"200":{"description":"Summary"}}}},"/v1/insurance/verify/{q}":{"get":{"summary":"Full insurance verification verdict","tags":["Insurance"],"parameters":[{"name":"q","in":"path","required":true,"schema":{"type":"string"}},{"name":"include_raw","in":"query","schema":{"type":"boolean","default":false},"description":"Attach the insurer portal's policy payload"}],"responses":{"200":{"description":"Verification result"}}}},"/v1/insurance/verified":{"get":{"summary":"Every verified carrier with verdict","tags":["Insurance"],"responses":{"200":{"description":"Verified carrier list"}}}},"/v1/insurance/{q}":{"get":{"summary":"FMCSA live lookup","tags":["Insurance"],"parameters":[{"name":"q","in":"path","required":true,"schema":{"type":"string"}},{"name":"include_raw","in":"query","schema":{"type":"boolean","default":false},"description":"Attach the raw FMCSA Socrata rows"}],"responses":{"200":{"description":"FMCSA data"}}}},"/v1/connections":{"get":{"summary":"Every connection with status and freshness","tags":["Platform"],"responses":{"200":{"description":"Connection list"}}},"post":{"summary":"Connect a system","tags":["Platform"],"responses":{"201":{"description":"Connection created"}}}},"/v1/invitations":{"get":{"summary":"Carrier invitations","tags":["Platform"],"responses":{"200":{"description":"Invitation list"}}},"post":{"summary":"Create a carrier invitation","tags":["Platform"],"responses":{"201":{"description":"Invitation created"}}}},"/v1/ai/stream":{"post":{"summary":"Ask Fennec AI (SSE streaming)","tags":["AI"],"responses":{"200":{"description":"SSE stream"}}}},"/mcp":{"get":{"summary":"MCP server info","tags":["AI Agents"],"responses":{"200":{"description":"Server info"}}},"post":{"summary":"MCP JSON-RPC endpoint","tags":["AI Agents"],"responses":{"200":{"description":"JSON-RPC response"}}}}},"tags":[{"name":"Telematics"},{"name":"TMS"},{"name":"Insurance"},{"name":"Platform"},{"name":"AI"},{"name":"AI Agents"}]}