Skip to content
SafetyRecord logoSafetyRecord

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_code on 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_withheld and new_value_withheld on each citation revision. A final_order_date outside 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 (source weekly_reconcile). The bulk_backfill source 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 by state, naics, opened_from and opened_to, newest first, cursor paged.
  • GET /v1/inspections/{activity_nr} and GET /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/status and GET /v1/openapi.json, no key needed.
  • Bearer key authentication, a monthly quota per key, RFC 9457 problem details for every error.