{
  "openapi": "3.0.3",
  "info": {
    "title": "OSHIFY API",
    "version": "0.1.0",
    "description": "Free, no-login access to normalized US safety and health incident data. Published statistics and reported incidents are not a compliance determination. Reporting is incomplete and uneven by source."
  },
  "paths": {
    "/v1/events": {
      "get": {
        "summary": "List OSHA severe injury report events (no employer, address or narrative)",
        "parameters": [
          {
            "name": "year_from",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "year_to",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "naics_prefix",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "naics_vintage",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "state",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "event",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "nature",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "part",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "source",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "amputation",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/events/aggregate": {
      "get": {
        "summary": "Count events grouped by event|nature|part|source|year|state|naics2|naics3",
        "parameters": [
          {
            "name": "by",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "year_from",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "year_to",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "naics_prefix",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "state",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/statistics/cfoi": {
      "get": {
        "summary": "BLS CFOI 2024 by industry: series=fatalities (by event or exposure) or series=rates (hours and fatal injury rate)",
        "parameters": [
          {
            "name": "series",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "naics",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ownership",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "event_group",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/snapshots": {
      "get": {
        "summary": "Dataset snapshots, sources, retrieval dates and license notes"
      }
    }
  }
}