Skip to main content
GET
List an employer’s events

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

types
string

Comma-separated event types: annual_summary, severe_injury, inspection, citation, accident.

Pattern: ^[a-z_]+(,[a-z_]+)*$
since
string<date>

Earliest event date, inclusive.

until
string<date>

Latest event date, inclusive.

siteId
string

Effective site ID: site_ followed by 20 hex characters.

Pattern: ^site_[0-9a-f]{20}$
limit
integer
default:25

Maximum number of items to return (1-100).

Required range: 1 <= x <= 100
cursor
string

Opaque nextCursor from this operation. Repeat every other query parameter unchanged; a cursor from a different query returns invalid_cursor.

Required string length: 1 - 8192

Response

One page of events.

events
object[]
required
nextCursor
string | null
required

Cursor for the next page, or null on the last page.