Mining Incidents API

Authentication

Every request carries the x-api-key header. Generate or rotate the key on /account after subscribing. Keys are sha256-hashed at rest; rotation invalidates the old key immediately.

curl https://miningincidents.org/api/export/msha \
  -H "x-api-key: mi_<your-32-byte-hex-key>" \
  --output msha-accidents.csv

Endpoints

Document No., Mine ID, Operator ID, Operator Name, Contractor ID,
Controller ID, Controller Name, State FIPS, County, Accident Date,
Accident Time, Degree of Injury Code, Degree of Injury,
Accident Classification, Accident Type, Occupation, Activity,
Location (Subunit), Nature of Injury, Body Part, Injury Source,
Total Experience (months), Mine Experience (months),
Job Experience (months), Sector, Year, Underground Location,
Mining Method, Narrative

Free public surfaces

A Pro subscription is not required for normal site use. The public surface is free and stable for citation:

• ·/search — keyword + filter search across every record
• ·/incident/[id] — canonical permalinks for every reportable accident; safe to cite in briefs and trade pubs
• ·/recent/feed.xml, /state/[abbr]/feed.xml, /classification/[slug]/feed.xml — RSS feeds for every taxonomy, polled by feed readers and integrators alike
• ·Email alerts: per-mine, per-operator, and saved-search subscriptions via the “Watch” CTAs on entity pages. No login required; verified by email round-trip.

Integration patterns

• Compliance dashboardPull a daily delta via the CSV export, diff against yesterday, surface new incidents at watched operators in your internal tooling.
• Matter-tracking integrationOn case intake, fetch the full accident history for the defendant operator and attach it to the matter record.
• Underwriting / risk scoringAggregate fatality and accident counts by operator and controller for risk-tier inputs to a P&C book.
• Research and analyticsBulk-export by date range for longitudinal analysis; every record carries the MSHA document number for cross-referencing with agency-level filings.

Limits and roadmap

Today the API is intentionally narrow — the CSV export is the primary surface and covers most use cases above. JSON endpoints (per-operator, per-incident, search) are on the near-term roadmap. If you have a specific endpoint shape you need before then, email austin@byshovel.com.