{"attribution":"MSHA data, cleaned and entity-resolved by miningincidents.org (CC BY 4.0)","boundary":"Free-tier facts only: event facts + entity aggregate totals. No per-citation line items, S\u0026S/negligence/gravity fields, contest posture, rate trends or benchmarks.","docs":"https://miningincidents.org/docs.md","endpoints":[{"filters":["since=YYYY-MM-DD","state=XX","commodity=coal|metal","classification=substr"],"method":"GET","path":"/api/x402/fatalities/count","price":"free","returns":"{total, columns} — row count + field schema only, no data values"},{"filters":["since=YYYY-MM-DD","state=XX","commodity=coal|metal","classification=substr","page=N"],"method":"GET","path":"/api/x402/fatalities","price":"$0.01","returns":"≤25 fatalities newest-first with lat/long, including open preliminary notices flagged source=preliminary"},{"method":"GET","path":"/api/x402/fatality/{id}","price":"$0.005","returns":"one official fatality: facts, classification, narrative, entity links"},{"method":"GET","path":"/api/x402/mine/{id}","price":"$0.01","returns":"mine profile facts + aggregate compliance/incident totals"},{"method":"GET","path":"/api/x402/mine/{id}/rates","price":"$0.02","returns":"rate-normalized mine safety: fatality + violation rates per 200k employee-hours (MSHA/BLS), hours worked, low-exposure flags"},{"method":"GET","path":"/api/x402/operator/{id}","price":"$0.02","returns":"operator identity + aggregate totals + up-to-25 fatality event list + rate_per_200k (fatality + violation rates per 200k employee-hours)"},{"method":"GET","path":"/api/x402/operator/{id}/contact","price":"$0.02","returns":"operator mailing address(es) of record: business name, contact title, location per distinct address; full street for corporate entities, city/state only for residential/individual rows"},{"method":"GET","path":"/api/x402/dossier/{id}","price":"$2.00","returns":"operator safety dossier: identity, mine list with status, full fatality list, aggregate violation/penalty totals with 24-month trend direction, plain-English flags"},{"filters":["name=\u003capproximate name\u003e","kind=operator|mine"],"method":"GET","path":"/api/x402/resolve","price":"$0.02","returns":"fuzzy name resolution: approximate/misspelled operator or mine name -\u003e ranked canonical entity ids with aggregate fatality/violation summaries (built from paid feature request #1)"},{"filters":["since=YYYY-MM-DD","mine_id=N","operator_id=N","commodity=coal|metal","page=N"],"method":"GET","path":"/api/x402/inspections","price":"$0.01","returns":"≤25 MSHA inspection events newest-first: dates, activity type, inspector count, on-site + inspection hours, sample counts, active/idle sections (raw activity facts; built from an /api/x402/inspections demand signal)"},{"filters":["page=N"],"method":"GET","path":"/api/x402/feature-requests","price":"free","returns":"≤25 feature requests, most-upvoted then newest first: {id, text, upvotes, status, created_at}"},{"filters":["text=\u003crequest, max 1000 chars\u003e"],"method":"GET","path":"/api/x402/feature-request","price":"$0.01","returns":"stores your feature request (the MSHA data/API you wish existed) for human review; the cent is a spam gate + demand signal"},{"method":"GET","path":"/api/x402/feature-request/{id}/upvote","price":"$0.01","returns":"upvotes an existing feature request by id; one counted vote per payer wallet"},{"description":"Resolve a messy US employer/company name to canonical identities in BOTH federal safety datasets: OSHA workplace safety records (safetyincidents.org) and MSHA mining records (miningincidents.org), with aggregate safety totals for each match.","external":true,"method":"GET","price":"$0.03","url":"https://safetyincidents.org/api/x402/resolve-employer"}],"license":"CC-BY-4.0","payment":"x402 (HTTP 402, USDC on Base, exact scheme). Fixed price per call; the count endpoint is free.","payment_enabled":true,"schema_version":1,"source":"Mining Incidents","source_url":"https://miningincidents.org"}