{"openapi":"3.1.1","info":{"title":"Mine accidents, injuries and illnesses by state, county and degree of injury (MSHA), 2000 to 2026: data API","version":"v1","summary":"Static, read-only JSON and CSV files. No key, no sign-up. CORS open.","description":"Mine accidents, injuries and illnesses by state, county and degree of injury (MSHA), 2000 to 2026: Accident, injury and illness reports that U.S. mine operators and contractors file with the Mine Safety and Health Administration, counted for the nation and for each state and calendar year from 2000 to October 2026, and for each county over the last ten full years (2016 to 2025), by degree of injury: deaths, permanent disabilities, lost-time injuries, restricted-activity injuries, injuries with no lost time and all other reports. State and national records also split reports and deaths between coal and metal/nonmetal mines. Counts only: no narratives, names of operators, occupations or ages are kept.\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/mine-accidents/index.json":{"get":{"summary":"Mine accidents, injuries and illnesses by state, county and degree of injury (MSHA), 2000 to 2026: index","description":"mine-accidents: meta, summary and what the dataset holds","parameters":[],"responses":{"200":{"description":"Mine accidents, injuries and illnesses by state, county and degree of injury (MSHA), 2000 to 2026: index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["mine-accidents"]}},"/data/v1/mine-accidents/changes.json":{"get":{"summary":"Mine accidents, injuries and illnesses by state, county and degree of injury (MSHA), 2000 to 2026: confirmed changes","description":"mine-accidents: confirmed changes, newest first","parameters":[],"responses":{"200":{"description":"Mine accidents, injuries and illnesses by state, county and degree of injury (MSHA), 2000 to 2026: confirmed changes","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["mine-accidents"]}},"/data/v1/mine-accidents/jurisdictions/{key}.json":{"get":{"summary":"Mine accidents, injuries and illnesses by state, county and degree of injury (MSHA), 2000 to 2026: one jurisdiction","description":"mine-accidents: 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":"Mine accidents, injuries and illnesses by state, county and degree of injury (MSHA), 2000 to 2026: one jurisdiction","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["mine-accidents"]}},"/data/v1/mine-accidents/mine-accidents.csv":{"get":{"summary":"Mine accidents, injuries and illnesses by state, county and degree of injury (MSHA), 2000 to 2026 as CSV","description":"mine-accidents: every record (credit line in README.txt)","parameters":[],"responses":{"200":{"description":"Mine accidents, injuries and illnesses by state, county and degree of injury (MSHA), 2000 to 2026 as CSV","content":{"text/csv":{"schema":{"type":"string"}}}},"404":{"description":"No such file"}},"tags":["mine-accidents"]}},"/data/v1/mine-accidents/mine-accidents.json":{"get":{"summary":"Mine accidents, injuries and illnesses by state, county and degree of injury (MSHA), 2000 to 2026: every record","description":"mine-accidents: every record in one file","parameters":[],"responses":{"200":{"description":"Mine accidents, injuries and illnesses by state, county and degree of injury (MSHA), 2000 to 2026: every record","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["mine-accidents"]}},"/data/v1/mine-accidents/search.json":{"get":{"summary":"Mine accidents, injuries and illnesses by state, county and degree of injury (MSHA), 2000 to 2026: keyword index","description":"mine-accidents: id, key, status and text of every record","parameters":[],"responses":{"200":{"description":"Mine accidents, injuries and illnesses by state, county and degree of injury (MSHA), 2000 to 2026: keyword index","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"No such file"}},"tags":["mine-accidents"]}},"/data/v1/mine-accidents/README.txt":{"get":{"summary":"Credit line, citation and columns","description":"mine-accidents: the CSV sidecar","parameters":[],"responses":{"200":{"description":"Credit line, citation and columns","content":{"text/plain":{"schema":{"type":"string"}}}},"404":{"description":"No such file"}},"tags":["mine-accidents"]}}},"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}}}}