Data API changelog
All notable changes to the SafetyRecord.org Data API are documented in this file.
The format is based on Keep a Changelog 1.1.0, and the API contract (openapi/v1.yaml) follows Semantic Versioning 2.0.0. Additive changes are minor versions. A breaking change gets a new path (/v2), and the old path stays available at least 6 months after the Deprecation and Sunset headers are first sent.
1.1.1 - 2026-10-20
Fixed
sic_codeon inspections is null when no SIC is recorded, like every other empty field. It was returned as an empty string.
1.1.0 - 2026-10-20
Added
old_value_withheldandnew_value_withheldon each citation revision. Afinal_order_dateoutside 1970 through next year is withheld in a revision as it is on the citation.
Changed
- Citation revisions list only values DOL's API returned that differed from the value we held (
sourceweekly_reconcile). Thebulk_backfillsource is removed: the 2026-10-07 bulk file updates filled our own copy and were not changes made by DOL. No revisions had been served when this changed.
1.0.0 - 2026-10-20
Added
GET /v1/inspections: list filtered bystate,naics,opened_fromandopened_to, newest first, cursor paged.GET /v1/inspections/{activity_nr}andGET /v1/inspections/{activity_nr}/citations.GET /v1/citations/{activity_nr}/{citation_id}and its/revisions: field changes detected since 2026-09-21, from the weekly reconcile against DOL's API and the 2026-10-07 correction from DOL's bulk file.GET /v1/establishments/{establishment_id}and its/inspections(beta): SafetyRecord.org's exact grouping of inspections by employer name, city and state.GET /v1/statusandGET /v1/openapi.json, no key needed.- Bearer key authentication, a monthly quota per key, RFC 9457 problem details for every error.