latestOpenAPI 3.0.22026-08-1451965.7 KB

f5a72ed18934

Employers

List MSHA violations

Per-citation MSHA mine-safety enforcement records for an employer.

Each row is one Mine Safety and Health Administration citation carrying its violation_no, the mine it occurred at, the section of the Mine Act cited, the agency's significant-and-substantial (S&S) flag, the negligence classification, proposed vs paid penalty, and whether the cited party was the mine operator or an on-site contractor. Aggregate rollups already live on the employer profile (msha_violations, msha_assessed_penalties); this endpoint backs them with the underlying citation roster.

Lookup: MSHA records carry no zip5 (mines are keyed by mine_id + county + state, not ZIP), so the join key is (name_normalized, state) resolved through the employer's own profile row. Mirrors the NLRB endpoint pattern.

Ordered: highest proposed_penalty first, then most-recent violation_date -- the citations that matter most surface on page 1.

Metered: one lookup per call, same as the other detail endpoints.

get/v1/employers/{employer_id}/msha-violations

Path parameters

employer_idstring required

Query parameters

limitinteger
offsetinteger

Headers

X-Api-Keystring

Response

Successful Response

{"stackTrail":"paths:/v1/employers/{employer_id}/msha-violations:get:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}