{"openapi":"3.0.3","info":{"title":"BrokerMafia Agent API","version":"1.0.0","description":"Public read-only HTTPS API for firm / FMCSA / vertical / search data. Hard rules: no live COUNT or aggregates on request paths; stats from offline brokermafia.stats / ASSETS only; search is capped (default 20, max 50).","contact":{"url":"https://brokermafia.com/agents/"}},"servers":[{"url":"https://brokermafia.com/api/v1"}],"paths":{"/health":{"get":{"operationId":"health","summary":"Liveness / agent discovery pointers","responses":{"200":{"description":"OK"}}}},"/stats":{"get":{"operationId":"getStats","summary":"Offline materialised directory stats (not live COUNT)","responses":{"200":{"description":"Stats payload"}}}},"/verticals":{"get":{"operationId":"listVerticals","summary":"Taxonomy of categories and verticals","responses":{"200":{"description":"Verticals"}}}},"/brokers/{slug}":{"get":{"operationId":"getBroker","summary":"Point lookup by firm slug","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Broker"},"404":{"description":"Not found"}}}},"/search":{"get":{"operationId":"searchBrokers","summary":"Capped search (require q|vertical|state|source; limit≤50)","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"vertical","in":"query","schema":{"type":"string"}},{"name":"state","in":"query","schema":{"type":"string"}},{"name":"source","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":50,"minimum":1}}],"responses":{"200":{"description":"Capped results"},"400":{"description":"Missing filter"}}}},"/fmcsa/mc/{mc}":{"get":{"operationId":"lookupFmcsaMc","summary":"Firm(s) by FMCSA MC/FF/MX docket","parameters":[{"name":"mc","in":"path","required":true,"schema":{"type":"string"},"example":"758091"}],"responses":{"200":{"description":"Matches"},"404":{"description":"Not found"}}}},"/fmcsa/usdot/{dot}":{"get":{"operationId":"lookupFmcsaUsdot","summary":"Firm(s) by USDOT number","parameters":[{"name":"dot","in":"path","required":true,"schema":{"type":"string"},"example":"2183369"}],"responses":{"200":{"description":"Matches"},"404":{"description":"Not found"}}}},"/openapi.json":{"get":{"operationId":"openapi","summary":"This OpenAPI document","responses":{"200":{"description":"OpenAPI 3 JSON"}}}},"/agent.json":{"get":{"operationId":"agentCard","summary":"Machine-readable agent card","responses":{"200":{"description":"Agent card"}}}}}}