latestOpenAPI 3.0.22026-08-1451965.7 KB

f5a72ed18934

Employers

Search employers

Search employers by name, EIN, zip, state, or NAICS.

Returns a flat list of employer locations sorted by total OSHA penalties (highest first). Each result includes related_locations_count showing how many locations share the same normalized employer name — useful for national chains.

get/v1/employers

Query parameters

namestring

Fuzzy employer name search

Fuzzy employer name search

einstring

Exact EIN match

Exact EIN match

statestring

State code filter (e.g., CA)

State code filter (e.g., CA)

zipstring

5-digit zip code filter

5-digit zip code filter

naicsstring

4-digit NAICS prefix filter

4-digit NAICS prefix filter

parent_onlyboolean

Only return employers with a parent_name (known parent companies)

Only return employers with a parent_name (known parent companies)

parent_namestring

Filter to locations under a specific parent company (exact match)

Filter to locations under a specific parent company (exact match)

has_fatalitiesboolean

Filter to locations with fatality investigations

Filter to locations with fatality investigations

svepboolean

Filter to locations on the Severe Violator Enforcement Program

Filter to locations on the Severe Violator Enforcement Program

sort_bystring

Sort results by: penalties (default), violations, inspections, fatalities

Sort results by: penalties (default), violations, inspections, fatalities

sort_dirstring

Sort direction: desc (default) or asc

Sort direction: desc (default) or asc

limitinteger
offsetinteger

Headers

X-Api-Keystring

Response

Successful Response

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