{"openapi":"3.1.1","info":{"title":"Vehicle safety complaints by state, make and model year (NHTSA complaint file): data API","version":"v1","summary":"Static, read-only JSON and CSV files. No key, no sign-up. CORS open.","description":"Vehicle safety complaints by state, make and model year (NHTSA complaint file): Safety complaints about cars, trucks, SUVs, motorcycles and RVs that owners filed with the National Highway Traffic Safety Administration (NHTSA), counted from its Office of Defects Investigation complaint file for the ten most recent model years, by the complainant's state, the make, the model year and the part of the vehicle named (engine, brakes, air bags, steering and the other NHTSA component groups). Each record gives the complaints, how many report a crash, a fire, an injury or a death, the people reported injured and killed, the complaints filed in the last twelve months, and how many concern a make, model and year that has a safety recall (and a recall of the same system), joined from NHTSA's recall file. State records list every make; make records add the model year by component table and each model's counts; national make records add each model by model year and the number of recall campaigns. A complaint is counted once however many parts it names. Only counts are kept: no narrative, VIN, city, name or complaint number.\n\nProbative is a marketing firm, not a law firm; not legal advice. Every JSON response starts with a \"meta\" object holding the credit line, citation, DOI and license (CC BY 4.0).","license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"},"contact":{"name":"Probative Growth","url":"https://probativegrowth.com/contact/","email":"hello@probativegrowth.com"}},"servers":[{"url":"https://probativegrowth.com"}],"externalDocs":{"description":"How to use the API and the MCP server","url":"https://probativegrowth.com/resources/rules-api/"},"paths":{"/data/v1/vehicle-complaints/index.json":{"get":{"summary":"Vehicle safety complaints by state, make and model year (NHTSA complaint file): index","description":"vehicle-complaints: meta, summary and what the dataset holds","parameters":[],"responses":{"200":{"description":"Vehicle safety complaints by state, make and model year (NHTSA complaint file): index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["vehicle-complaints"]}},"/data/v1/vehicle-complaints/changes.json":{"get":{"summary":"Vehicle safety complaints by state, make and model year (NHTSA complaint file): confirmed changes","description":"vehicle-complaints: confirmed changes, newest first","parameters":[],"responses":{"200":{"description":"Vehicle safety complaints by state, make and model year (NHTSA complaint file): confirmed changes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["vehicle-complaints"]}},"/data/v1/vehicle-complaints/jurisdictions/{key}.json":{"get":{"summary":"Vehicle safety complaints by state, make and model year (NHTSA complaint file): one jurisdiction","description":"vehicle-complaints: the records for one jurisdiction","parameters":[{"name":"key","in":"path","required":true,"description":"The jurisdiction key, uppercase","schema":{"type":"string"}}],"responses":{"200":{"description":"Vehicle safety complaints by state, make and model year (NHTSA complaint file): one jurisdiction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["vehicle-complaints"]}},"/data/v1/vehicle-complaints/vehicle-complaints.csv":{"get":{"summary":"Vehicle safety complaints by state, make and model year (NHTSA complaint file) as CSV","description":"vehicle-complaints: every record (credit line in README.txt)","parameters":[],"responses":{"200":{"description":"Vehicle safety complaints by state, make and model year (NHTSA complaint file) as CSV","content":{"text/csv":{"schema":{"type":"string"}}}},"404":{"description":"No such file"}},"tags":["vehicle-complaints"]}},"/data/v1/vehicle-complaints/vehicle-complaints.json":{"get":{"summary":"Vehicle safety complaints by state, make and model year (NHTSA complaint file): every record","description":"vehicle-complaints: every record in one file","parameters":[],"responses":{"200":{"description":"Vehicle safety complaints by state, make and model year (NHTSA complaint file): every record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["vehicle-complaints"]}},"/data/v1/vehicle-complaints/search.json":{"get":{"summary":"Vehicle safety complaints by state, make and model year (NHTSA complaint file): keyword index","description":"vehicle-complaints: id, key, status and text of every record","parameters":[],"responses":{"200":{"description":"Vehicle safety complaints by state, make and model year (NHTSA complaint file): keyword index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["vehicle-complaints"]}},"/data/v1/vehicle-complaints/README.txt":{"get":{"summary":"Credit line, citation and columns","description":"vehicle-complaints: the CSV sidecar","parameters":[],"responses":{"200":{"description":"Credit line, citation and columns","content":{"text/plain":{"schema":{"type":"string"}}}},"404":{"description":"No such file"}},"tags":["vehicle-complaints"]}}},"components":{"schemas":{"Meta":{"type":"object","description":"Credit line, citation, DOI, version, license and disclaimer. Present in every response.","required":["dataset","version","license","attribution","disclaimer","url"],"properties":{"dataset":{"type":"string"},"title":{"type":"string"},"version":{"type":"string"},"doi":{"type":["string","null"]},"doiUrl":{"type":["string","null"]},"conceptDoi":{"type":["string","null"]},"license":{"type":"string","const":"CC BY 4.0"},"licenseUrl":{"type":"string"},"attribution":{"type":"string"},"citation":{"type":"string"},"disclaimer":{"type":"string"},"notice":{"type":"string"},"lastChecked":{"type":"string"},"url":{"type":"string"},"humanUrl":{"type":"string"},"statusCodes":{"type":"object"}}},"Envelope":{"type":"object","required":["meta"],"properties":{"meta":{"$ref":"#/components/schemas/Meta"}},"additionalProperties":true}}}}