{"uid":"cap_ysBbzeSio_q3yBQiA7ZrT","slug":"msha-violations-search-d819d600","name":"MSHA Violations Search","description":"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.","url":"https://api.govparse.io/v1/msha/violations/search","method":"GET","headers":{},"bodySchema":{"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":{"type":"string","examples":["M09902"],"description":"MSHA violator/operator id(s), CSV."},"part_section":{"type":"string","examples":["75.400"],"description":"Cited 30 CFR part/section fragment (the standard cited)."},"violator_type":{"type":"string","examples":["Operator"],"description":"Operator | Contractor | Agent | Miner (CSV)."},"section_of_act":{"type":"string","examples":["104(a)"],"description":"Mine Act section fragment."},"enforcement_area":{"type":"string","examples":["Safety"],"description":"Health/safety hazard designation fragment."}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_D30yoOB88Su7eZFdmZmug","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search MSHA mine safety citations and orders by company, mine, standard, state, or other criteria to retrieve violation records with penalties and dates","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Vendor safety due diligence","prompt":"Before we hire Foresight Mining as a contractor, can you pull their MSHA violation history — especially any high-negligence or S&S orders from the last two years — so I can assess their safety record?"},{"title":"Regulatory compliance audit by CFR standard","prompt":"Show me all MSHA citations referencing 30 CFR 75.400 (combustible materials) issued at coal mines since January 2024, sorted by penalty amount, so I can benchmark how often that standard is being cited."},{"title":"State-level mine safety monitoring","prompt":"Which metal and non-metal mines in Nevada have received MSHA orders — not just citations — in 2025? Give me up to 50 results sorted by issue date so I can see the most recent enforcement actions."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:47:01.219Z","isFirstParty":false}