# Mining Incidents MSHA Operator Dossier

> Mining Incidents MSHA Operator Dossier is a paid API for AI agents from miningincidents.org, paid per call via x402, $2/call, status unknown (last checked 2026-09-13).

Returns a comprehensive safety dossier for a US mining operator, including mine list, fatality records, citation counts, penalty totals, and violation trends from MSHA data.

## Facts

- Endpoint: GET https://miningincidents.org/api/x402/dossier/0125574
- Price: $2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mining-incidents-msha-operator-dossier-db8a2dce
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_858Mzsz3bQ0Fw6zv-20oa

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability mining-incidents-msha-operator-dossier-db8a2dce
```

Example prompt: Pull up the full MSHA safety dossier for operator ID 1200001 — I want to see their fatalities, citation count, penalty totals, and whether their violation trend is going up or down.

## When to prefer this

Use this endpoint when you need a consolidated, pre-aggregated safety profile for a specific mining operator by ID, including trend analysis and fatality detail — rather than querying raw incident or citation feeds separately. Prefer this over individual mine-level endpoints when the user cares about operator-wide risk across all mines.

## Known failure modes

- Invalid or unknown operator ID returns empty or error response
- Operator with no MSHA records may return zero counts but valid structure
- Network or payment failure returns 402 or connection error
- Data may lag up to one week behind MSHA's latest published records

## How this service works

Mining Incidents is a free, searchable database and research tool covering every reportable US mining incident on file with MSHA. Search by mine, operator, controller, state, year, severity, or any keyword in the investigator's narrative. 1983 to present, refreshed weekly.

## Output

A JSON object containing: operator identity fields (name, ID, first/last citation dates), aggregate totals (accident count, citation count, S&S count, fatality count, penalty proposed and paid totals), a list of associated mines with state, county, commodity, type, and status, a full fatality event list with classification and date, a 24-month violation trend comparison showing citation and penalty direction, and a set of plain-English flag strings summarizing key risk signals. Also includes links to the human-readable page and full report.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "flags": [
   "2 fatalities on record; most recent 2026-04-02.",
   "Citation volume is rising vs the prior 24 months.",
   "Proposed penalty dollars are falling vs the prior 24 months.",
   "3 of 8 listed mines are currently active."
  ],
  "links": {
   "human_page": "https://miningincidents.org/operator/1200001",
   "full_report": "https://miningincidents.org/sample-report"
  },
  "mines": {
   "rows": [
    {
     "state": "WV",
     "county": "Boone",
     "mine_id": "4608791",
     "commodity": "coal",
     "mine_name": "Example Mine",
     "mine_type": "Surface",
     "mine_status": "Active"
    }
   ],
   "total": 8,
   "active": 3,
   "returned": 8
  },
  "source": "Mining Incidents",
  "endpoint": "operator_dossier",
  "operator": {
   "ss_count": 410,
   "operator_id": "1200001",
   "operator_name": "Example Operator",
   "accident_count": 40,
   "citation_count": 3200,
   "fatality_count": 2,
   "last_citation_dt": "2026-05-01",
   "first_citation_dt": "2001-03-12",
   "penalty_paid_total": 1200000,
   "penalty_proposed_total": 1500000
  },
  "fatalities": {
   "rows": [
    {
     "id": "3609820",
     "state": "WV",
     "mine_id": "4608791",
     "commodity": "coal",
     "mine_name": "Example Mine",
     "event_date": "2026-04-02",
     "classification": "Fall of roof or back"
    }
   ],
   "total": 2,
   "returned": 2
  },
  "schema_version": 1,
  "violation_trend": {
   "penalty_trend": "falling",
   "window_months": 24,
   "citation_trend": "rising",
   "citations_prior": 80,
   "citations_current": 120,
   "prior_window_start": "2022-07-18",
   "current_window_start": "2024-07-18",
   "penalty_proposed_prior_usd": 310000,
   "penalty_proposed_current_usd": 250000
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mining-incidents-msha-operator-dossier-db8a2dce/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from miningincidents.org](https://www.zero.xyz/host/miningincidents.org/llms.txt)