# MSHA Violations Search

> MSHA Violations Search is a paid API for AI agents from api.govparse.io, paid per call via x402, $1.25/call, status unknown (last checked 2026-09-14).

Search MSHA mine safety citations and orders by company, mine, standard, state, or other criteria to retrieve violation records with penalties and dates

## Facts

- Endpoint: GET https://api.govparse.io/v1/msha/violations/search
- Price: $1.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/msha-violations-search-d819d600
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ysBbzeSio_q3yBQiA7ZrT

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-violations-search-d819d600
```

Example prompt: Pull all MSHA S&S citations issued to Consol Energy in West Virginia coal mines since 2023, sorted by issue date descending, and show me the standard cited and penalty for each.

## When to prefer this

Use this endpoint when you need structured, filterable access to MSHA enforcement records — citations, orders, and penalties — for coal or metal/non-metal mines. It is the right choice for due diligence on mining operators or contractors, regulatory compliance research by CFR standard, and monitoring enforcement trends by state or date range. Prefer it over general web search when you need structured fields like penalty amounts, negligence classifications, and S&S flags, or when you need entity-resolved violator IDs for cross-referencing.

## Known failure modes

- No results returned when company name spelling or suffix differs from MSHA record — use suffix-insensitive search or violator_id instead
- Invalid state code or mine_id format returns an error or empty result set
- Requests exceeding the 100-row cap require pagination via offset parameter
- Date format must be YYYY-MM-DD or year as 4-digit string; malformed dates cause query failures
- part_section fragment must match a real 30 CFR section; unrecognized fragments return empty results

## How this service works

Which mine operators have MSHA citations or orders? Search the MSHA Violations data set (citations & orders at coal & M/NM mines) by cited company, mine id, state, cited 30 CFR standard (part_section), Mine Act section, citation/order type, health/safety area, negligence, likelihood, S&S (sig_sub), contested, year, or issue date (since). Returns the cited violator (entity-resolved), mine, standard cited, penalty, and dates. Reported exactly as cited, not a safety judgment.

## Output

Returns a paginated list of MSHA violation records, each including the entity-resolved cited violator, mine ID, state, 30 CFR standard cited, citation/order type, penalty assessed, issue date, negligence degree, likelihood of injury, S&S flag, and contested status. Data is reported exactly as cited by MSHA inspectors.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [],
   "properties": {
    "sort": {
     "type": "string",
     "examples": [
      "issue_date:desc"
     ],
     "description": "issue_date | penalty | affected :asc|:desc. Default issue_date:desc."
    },
    "year": {
     "type": "string",
     "examples": [
      "2025"
     ],
     "description": "Calendar year of issuance."
    },
    "limit": {
     "type": "integer",
     "examples": [
      25
     ],
     "description": "Max rows (default 25, cap 100)."
    },
    "since": {
     "type": "string",
     "examples": [
      "2026-01-01"
     ],
     "description": "Issued on/after this date (YYYY-MM-DD)."
    },
    "state": {
     "type": "string",
     "examples": [
      "KY"
     ],
     "description": "State code(s), CSV (from the mine)."
    },
    "offset": {
     "type": "integer",
     "examples": [
      0
     ],
     "description": "Rows to skip."
    },
    "cit_ord": {
     "type": "string",
     "examples": [
      "Order"
     ],
     "description": "Citation | Order | Safeguard (CSV)."
    },
    "company": {
     "type": "string",
     "examples": [
      "Consol"
     ],
     "description": "Cited violator (operator/contractor) name — suffix/punctuation-insensitive."
    },
    "mine_id": {
     "type": "string",
     "examples": [
      "1202215"
     ],
     "description": "MSHA mine id(s), CSV."
    },
    "sig_sub": {
     "type": "string",
     "examples": [
      "true"
     ],
     "description": "true = Significant & Substantial (S&S) citations only."
    },
    "contested": {
     "type": "string",
     "examples": [
      "true"
     ],
     "description": "true = contested citations only."
    },
    "entity_id": {
     "type": "string",
     "examples": [
      "b7f3e2d1-4a5c-4e6f-8a9b-0c1d2e3f4a5b"
     ],
     "description": "Resolved violator entity UUID."
    },
    "coal_metal": {
     "type": "string",
     "examples": [
      "C"
     ],
     "description": "C = coal, M = metal/non-metal."
    },
    "likelihood": {
     "type": "string",
     "examples": [
      "Reasonably"
     ],
     "description": "Accident likelihood (Highly | Reasonably | Unlikely | Occurred | NoLikelihood), CSV."
    },
    "negligence": {
     "type": "string",
     "examples": [
      "HighNegligence"
     ],
     "description": "Negligence degree (CSV)."
    },
    "violator_id": {
   
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/msha-violations-search-d819d600/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.govparse.io](https://www.zero.xyz/host/api.govparse.io/llms.txt)