# MSHA Mining Fatalities Feed

> MSHA Mining Fatalities Feed is a paid API for AI agents from miningincidents.org, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns a paginated, date-sorted feed of MSHA mining fatality records including preliminary notices scraped 32–180 days ahead of the official dataset, filterable by date, state, and commodity.

## Facts

- Endpoint: GET https://miningincidents.org/api/x402/fatalities
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/msha-mining-fatalities-feed-30e34f6d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0kVoJpPVnPoU7He-qQNUr

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 msha-mining-fatalities-feed-30e34f6d
```

Example prompt: Pull me the latest MSHA mining fatality reports from miningincidents.org — filter for coal mining in West Virginia since 2024-01-01, including any open preliminary notices.

## When to prefer this

Use this endpoint when you need mining fatality data earlier than the official MSHA public dataset (up to 180 days ahead), want to filter by state, commodity, or accident classification, or need to monitor for newly opened preliminary fatality notices. Prefer this over direct MSHA scraping for timeliness and structured access.

## Known failure modes

- Invalid date format for 'since' parameter returns 400 error
- Unknown state abbreviation returns empty result set or 400
- Commodity value outside enum ('coal','metal') returns validation error
- Page number below 1 returns 400
- No matching records for given filters returns empty list
- Payment not processed (402) if x402 authentication fails

## How this service works

MSHA mining fatalities feed, newest first, including OPEN preliminary notices (scraped 32–180 days ahead of the official dataset and flagged as preliminary). Filter by date, state, commodity.

## Output

A paginated JSON list of mining fatality records sorted newest-first, each including event date, state, commodity, accident classification, operator and mine identifiers, narrative text, and a flag indicating whether the record is a preliminary (open) notice not yet in the official MSHA dataset.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "page": 1,
  "rows": [
   {
    "id": "a1b2c3d4",
    "state": null,
    "source": "preliminary",
    "latitude": null,
    "commodity": "coal",
    "longitude": null,
    "mine_name": "Example Mine No. 1",
    "event_date": "2026-05-14",
    "source_url": "https://www.msha.gov/data-and-reports/fatality-reports",
    "description": "Miner fatally injured in a haulage incident.",
    "preliminary": true,
    "operator_name": null,
    "classification": "Powered haulage",
    "controller_name": "Example Coal Company"
   }
  ],
  "source": "Mining Incidents",
  "endpoint": "fatalities",
  "returned": 25,
  "next_page": 2,
  "page_size": 25,
  "total_matches": 128,
  "schema_version": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/msha-mining-fatalities-feed-30e34f6d/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)