---
title: "Top OSHA standards cited"
method: GET
path: "/v1/employers/{employer_id}/osha-standards"
tags: ["Employers"]
---

# Top OSHA standards cited

`GET /v1/employers/{employer_id}/osha-standards`

## Request

- Base URL: `https://api.fastdol.com`
- URL: `https://api.fastdol.com/v1/employers/{employer_id}/osha-standards`
- Auth: API key in header `X-Api-Key`
- TypeScript: <https://skmtc.dev/fastdol/apis/fastdol-api/docs/v1/employers/:employer_id/osha-standards/get.ts> (a function with typed inputs; its response is checked against the schema)

Per-employer rollup of OSHA standards cited.

For a given employer, aggregate every citation across every
inspection by the CFR `standard` column and surface the most-cited
standards. Customers see the OSHA aggregate tile ("47 violations")
but the *pattern* -- "23 of those 47 were under CFR 1910.147
Lockout/Tagout" -- is the asymmetric add. Per-inspection drilldown
is already available via /v1/inspections/{activity_nr}/violations;
this endpoint is the rollup that's otherwise invisible to a
customer scanning the employer page.

Joins `violation_detail` (per-citation) to `inspection_detail`
(per-inspection) on `activity_nr` so we can filter by `employer_id`.
GROUP BY `standard`. Per-standard aggregates returned:
  - citation_count
  - total_penalty (sum of current_penalty, falling back to
    initial_penalty when current is NULL)
  - last_citation_date (MAX of issuance_date)
  - first_citation_date (MIN of issuance_date)
  - inspection_count (DISTINCT activity_nr)

Ordered: citation_count DESC, then total_penalty DESC, then
last_citation_date DESC. The most-frequent and highest-dollar
standards land on page 1 of any paginated view.

NOT metered as a separate lookup beyond the standard IP throttle --
this is a roll-up over data the customer already has the right to
see, not a new data slice.

## Path parameters

- `employer_id` string, required

## Query parameters

- `limit` integer

## Headers

- `X-Api-Key` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fastdol/apis/fastdol-api.md) - [All operations](https://skmtc.dev/fastdol/apis/fastdol-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fastdol/apis/fastdol-api/revisions/c70ba279bbb2?raw)