{"openapi":"3.1.0","info":{"title":"vanline.ai","version":"1.0.0","description":"US federal licensing records for every company with a household goods moving filing, reproduced from FMCSA data as filed. No key; CORS is open. Every record carries its source and dates: quote licensing_as_of with any authority or insurance fact. Nothing here is a rating, ranking or endorsement."},"servers":[{"url":"https://vanline.ai"}],"paths":{"/api/movers/{usdot}":{"get":{"operationId":"getMover","summary":"One company's federal record by USDOT number","description":"Operating authority (carrier, broker, both or none), insurance on file, address, fleet, and the source and dates of each fact.","parameters":[{"name":"usdot","in":"path","required":true,"description":"USDOT number, 1 to 8 digits","schema":{"type":"string","pattern":"^\\d{1,8}$"}}],"responses":{"200":{"description":"The record.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Record"}}}},"400":{"description":"The request was not valid. The body says why.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No company with a household goods filing has that USDOT number.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/search":{"get":{"operationId":"searchMovers","summary":"Find companies by name, USDOT number or docket (MC) number","parameters":[{"name":"q","in":"query","required":true,"description":"At least two characters","schema":{"type":"string","minLength":2}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"Matching companies.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResult"}}}},"400":{"description":"The request was not valid. The body says why.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/changes":{"get":{"operationId":"recentChanges","summary":"Changes recorded in movers' federal filings, newest first","description":"recorded_on is the day vanline.ai first saw a change, not the day FMCSA acted.","parameters":[{"name":"kind","in":"query","required":false,"description":"Comma-separated kinds of change","schema":{"type":"string"},"example":"new_registration,authority_lost"},{"name":"state","in":"query","required":false,"description":"Two-letter state code","schema":{"type":"string","pattern":"^[A-Za-z]{2}$"}},{"name":"since","in":"query","required":false,"description":"YYYY-MM-DD; changes recorded on or after","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":100}}],"responses":{"200":{"description":"Changes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Changes"}}}},"400":{"description":"The request was not valid. The body says why.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}}},"Record":{"type":"object","properties":{"usdot":{"type":"string"},"docket":{"type":["string","null"]},"legal_name":{"type":"string"},"dba_name":{"type":["string","null"]},"entity_type":{"type":"string","enum":["carrier","broker","both","none"]},"entity_type_meaning":{"type":"string"},"operating_authority":{"type":"object"},"insurance":{"type":"object"},"operations":{"type":"object"},"location":{"type":"object"},"phone":{"type":["string","null"]},"observations":{"type":"object"},"source":{"type":"object","properties":{"retrieved":{"type":"string","format":"date"},"licensing_source":{"type":"string"},"licensing_as_of":{"type":"string","format":"date"}}},"citation":{"type":"string"},"disclaimer":{"type":"string"}}},"SearchResult":{"type":"object","properties":{"query":{"type":"string"},"count":{"type":"integer"},"results":{"type":"array","items":{"type":"object","properties":{"usdot":{"type":"string"},"name":{"type":"string"},"entity_type":{"type":"string","enum":["carrier","broker","both","none"]},"city":{"type":["string","null"]},"state":{"type":["string","null"]},"cargo_insurance_on_file":{"type":"boolean"},"record":{"type":"string","format":"uri"},"json":{"type":"string","format":"uri"}}}}}},"Changes":{"type":"object","properties":{"count":{"type":"integer"},"changes":{"type":"array","items":{"type":"object","properties":{"usdot":{"type":"string"},"name":{"type":"string"},"location":{"type":["string","null"]},"kind":{"type":"string","enum":["authority_lost","authority_gained","revocation_started","revocation_cleared","cargo_lapsed","cargo_filed","moved","renamed","new_registration","other"]},"kind_label":{"type":"string"},"recorded_on":{"type":"string","format":"date"},"record_url":{"type":"string","format":"uri"}}}},"note":{"type":"string"}}}}}}