Skip to main content
GET
Get an employer’s OSHA profile

Authorizations

Authorization
string
header
required

Effective API key. Send Authorization: Bearer sk-eai-...

Path Parameters

employerId
string
required

Effective employer ID: emp_ followed by 20 hex characters.

Pattern: ^emp_[0-9a-f]{20}$

Query Parameters

years
integer
default:5

Number of Form 300A years, ending with the latest year OSHA has published.

Required range: 1 <= x <= 10
siteId
string

Limit the profile to one of the employer’s sites.

Pattern: ^site_[0-9a-f]{20}$

Response

The OSHA profile.

employerId
string
required

Effective employer ID: emp_ followed by 20 hex characters.

Pattern: ^emp_[0-9a-f]{20}$
siteId
string | null
required

Effective site ID: site_ followed by 20 hex characters.

Pattern: ^site_[0-9a-f]{20}$
dataVersion
string | null
required

Version of the employer and site matching. It changes each time matching is rebuilt after an OSHA load (weekly). Null before the first build.

window
object
required

Dates the inspection, citation, injury and fatality counts cover, inclusive.

years
object[]
required

Newest first.

inspections
object
required
citations
object
required

Citations OSHA has not deleted, by violation type.

penalties
object
required

Sums over the window’s citations.

severeInjuries
object
required
fatalities
object
required