{"openapi":"3.1.1","info":{"title":"Injury deaths by county and state (CDC): drug overdose, suicide, homicide and firearm injury: data API","version":"v1","summary":"Static, read-only JSON and CSV files. No key, no sign-up. CORS open.","description":"Injury deaths by county and state (CDC): drug overdose, suicide, homicide and firearm injury: Deaths from drug overdose, suicide, homicide and firearm injury in CDC's Mapping Injury, Overdose, and Violence files, for the nation, each state and DC and each county, by calendar year and for the trailing twelve months: deaths and the rate per 100,000 residents. National and state records add unintentional-injury deaths from the NCHS leading-causes file, 1999 to 2017. Counts of 1 to 9 stay in the range CDC prints.\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/injury-deaths/index.json":{"get":{"summary":"Injury deaths by county and state (CDC): drug overdose, suicide, homicide and firearm injury: index","description":"injury-deaths: meta, summary and what the dataset holds","parameters":[],"responses":{"200":{"description":"Injury deaths by county and state (CDC): drug overdose, suicide, homicide and firearm injury: index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["injury-deaths"]}},"/data/v1/injury-deaths/changes.json":{"get":{"summary":"Injury deaths by county and state (CDC): drug overdose, suicide, homicide and firearm injury: confirmed changes","description":"injury-deaths: confirmed changes, newest first","parameters":[],"responses":{"200":{"description":"Injury deaths by county and state (CDC): drug overdose, suicide, homicide and firearm injury: confirmed changes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["injury-deaths"]}},"/data/v1/injury-deaths/jurisdictions/{key}.json":{"get":{"summary":"Injury deaths by county and state (CDC): drug overdose, suicide, homicide and firearm injury: one jurisdiction","description":"injury-deaths: the records for one jurisdiction","parameters":[{"name":"key","in":"path","required":true,"description":"The jurisdiction key, uppercase","schema":{"type":"string"},"example":"AK"}],"responses":{"200":{"description":"Injury deaths by county and state (CDC): drug overdose, suicide, homicide and firearm injury: one jurisdiction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["injury-deaths"]}},"/data/v1/injury-deaths/injury-deaths.csv":{"get":{"summary":"Injury deaths by county and state (CDC): drug overdose, suicide, homicide and firearm injury as CSV","description":"injury-deaths: every record (credit line in README.txt)","parameters":[],"responses":{"200":{"description":"Injury deaths by county and state (CDC): drug overdose, suicide, homicide and firearm injury as CSV","content":{"text/csv":{"schema":{"type":"string"}}}},"404":{"description":"No such file"}},"tags":["injury-deaths"]}},"/data/v1/injury-deaths/injury-deaths.json":{"get":{"summary":"Injury deaths by county and state (CDC): drug overdose, suicide, homicide and firearm injury: every record","description":"injury-deaths: every record in one file","parameters":[],"responses":{"200":{"description":"Injury deaths by county and state (CDC): drug overdose, suicide, homicide and firearm injury: every record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["injury-deaths"]}},"/data/v1/injury-deaths/search.json":{"get":{"summary":"Injury deaths by county and state (CDC): drug overdose, suicide, homicide and firearm injury: keyword index","description":"injury-deaths: id, key, status and text of every record","parameters":[],"responses":{"200":{"description":"Injury deaths by county and state (CDC): drug overdose, suicide, homicide and firearm injury: keyword index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["injury-deaths"]}},"/data/v1/injury-deaths/README.txt":{"get":{"summary":"Credit line, citation and columns","description":"injury-deaths: the CSV sidecar","parameters":[],"responses":{"200":{"description":"Credit line, citation and columns","content":{"text/plain":{"schema":{"type":"string"}}}},"404":{"description":"No such file"}},"tags":["injury-deaths"]}}},"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"},"doiUrl":{"type":"string"},"conceptDoi":{"type":"string"},"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"}}},"Source":{"type":"object","description":"Who to credit and how: publisher, the dataset page, version, license and the standard citation string. On every dataset file with a meta object (the catalog lists it per dataset).","required":["publisher","page","version","license","citeAs"],"properties":{"publisher":{"type":"string","const":"Probative Growth"},"page":{"type":"string","description":"The dataset page to cite and link"},"version":{"type":"string"},"license":{"type":"string","const":"CC BY 4.0"},"citeAs":{"type":"string","description":"Probative Growth, <dataset title>, <year>, <DOI link or dataset page>"}},"additionalProperties":false},"Envelope":{"type":"object","required":["meta"],"properties":{"meta":{"$ref":"#/components/schemas/Meta"},"source":{"$ref":"#/components/schemas/Source"}},"additionalProperties":true}}}}