> ## Documentation Index
> Fetch the complete documentation index at: https://docs.effectiveai.app/llms.txt
> Use this file to discover all available pages before exploring further.

# List OSHA severe injury reports

> OSHA severe injury reports: hospitalizations, amputations and losses of an eye that employers must report within 24 hours. OSHA’s rows as published, under OSHA’s own column names in camelCase. Each row also carries the employerId and siteId Effective matched it to (null if unmatched) and the OSHA file it came from. Newest first. To page, repeat the same filters and limit with cursor set to nextCursor. Read one with GET /insurance/osha/severe-injury-reports/{id}. Needs the OSHA dataset enabled for your organization. Read-only; private, no-store. 



## OpenAPI

````yaml /openapi.json get /insurance/osha/severe-injury-reports
openapi: 3.0.3
info:
  title: Effective API
  version: 2.0.0
  description: The public Effective REST API. Authenticate using an Effective API key.
servers:
  - url: https://api.effectiveai.app/api/v2
    description: Production
security:
  - bearerAuth: []
paths:
  /insurance/osha/severe-injury-reports:
    get:
      tags:
        - OSHA
      summary: List OSHA severe injury reports
      description: >-
        OSHA severe injury reports: hospitalizations, amputations and losses of
        an eye that employers must report within 24 hours. OSHA’s rows as
        published, under OSHA’s own column names in camelCase. Each row also
        carries the employerId and siteId Effective matched it to (null if
        unmatched) and the OSHA file it came from. Newest first. To page, repeat
        the same filters and limit with cursor set to nextCursor. Read one with
        GET /insurance/osha/severe-injury-reports/{id}. Needs the OSHA dataset
        enabled for your organization. Read-only; private, no-store. 
      operationId: listOshaSevereInjuryReports
      parameters:
        - schema:
            type: string
            pattern: ^emp_[0-9a-f]{20}$
            description: 'Effective employer ID: emp_ followed by 20 hex characters.'
          required: false
          description: 'Effective employer ID: emp_ followed by 20 hex characters.'
          name: employerId
          in: query
        - schema:
            type: string
            pattern: ^site_[0-9a-f]{20}$
            description: 'Effective site ID: site_ followed by 20 hex characters.'
          required: false
          description: 'Effective site ID: site_ followed by 20 hex characters.'
          name: siteId
          in: query
        - schema:
            type: string
            pattern: ^[A-Za-z]{2}$
            description: Two-letter state code, such as FL.
          required: false
          description: Two-letter state code, such as FL.
          name: state
          in: query
        - schema:
            type: string
            pattern: ^\d{5}$
            description: Five-digit ZIP code.
          required: false
          description: Five-digit ZIP code.
          name: zip
          in: query
        - schema:
            type: string
            pattern: ^\d{2,6}$
            description: >-
              NAICS code or prefix, 2 to 6 digits. 2381 matches every 2381xx
              code.
          required: false
          description: NAICS code or prefix, 2 to 6 digits. 2381 matches every 2381xx code.
          name: naics
          in: query
        - schema:
            type: string
            format: date
            description: Earliest event date, inclusive.
          required: false
          description: Earliest event date, inclusive.
          name: eventDateFrom
          in: query
        - schema:
            type: string
            format: date
            description: Latest event date, inclusive.
          required: false
          description: Latest event date, inclusive.
          name: eventDateTo
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
            description: Maximum number of items to return (1-100).
          required: false
          description: Maximum number of items to return (1-100).
          name: limit
          in: query
        - schema:
            type: string
            minLength: 1
            maxLength: 8192
            description: >-
              Opaque nextCursor from this operation. Repeat every other query
              parameter unchanged; a cursor from a different query returns
              invalid_cursor.
          required: false
          description: >-
            Opaque nextCursor from this operation. Repeat every other query
            parameter unchanged; a cursor from a different query returns
            invalid_cursor.
          name: cursor
          in: query
      responses:
        '200':
          description: One page of severe injury reports.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2OshaSevereInjuryReports'
        '400':
          description: >-
            invalid_request for invalid, unknown or repeated inputs;
            invalid_cursor means restart the list.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '401':
          description: Authentication required.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '403':
          description: >-
            dataset_not_enabled: the OSHA dataset is not enabled for this
            organization. Other credential restrictions use forbidden.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '404':
          description: 'not_found: no such employer, site or OSHA row.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '500':
          description: Unexpected server failure.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
        '503':
          description: A dependency is unavailable; respect Retry-After.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2CodedError'
      security:
        - bearerAuth: []
components:
  schemas:
    V2OshaSevereInjuryReports:
      type: object
      properties:
        severeInjuryReports:
          type: array
          items:
            $ref: '#/components/schemas/V2OshaSevereInjuryReport'
        nextCursor:
          type: string
          nullable: true
          description: Cursor for the next page, or null on the last page.
      required:
        - severeInjuryReports
        - nextCursor
    V2CodedError:
      allOf:
        - $ref: '#/components/schemas/V2Error'
        - type: object
          properties:
            code:
              type: string
              minLength: 1
              description: Stable error code. Clients must tolerate unknown future codes.
            details:
              type: array
              items:
                type: object
                properties:
                  location:
                    type: string
                    enum:
                      - path
                      - query
                      - header
                      - body
                  path:
                    type: array
                    items:
                      type: string
                      maxLength: 64
                    maxItems: 12
                  code:
                    type: string
                    enum:
                      - required
                      - invalid_type
                      - invalid_value
                      - unknown_field
                  message:
                    type: string
                    minLength: 1
                    maxLength: 200
                required:
                  - location
                  - path
                  - code
                  - message
              minItems: 1
              maxItems: 20
              description: Bounded safe validation issues; may omit some invalid fields.
            requestId:
              type: string
              minLength: 1
              maxLength: 128
              description: >-
                Existing server correlation for this HTTP attempt, when
                available.
            dataset:
              type: string
              enum:
                - naic
                - osha
              description: Dataset needed for dataset_not_enabled.
            accessUrl:
              type: string
              nullable: true
              format: uri
              description: >-
                Where to add the product to your account, for
                product_access_required.
          required:
            - code
    V2OshaSevereInjuryReport:
      type: object
      properties:
        id:
          type: string
          description: OSHA’s report ID.
        upa:
          type: string
          nullable: true
        eventdate:
          type: string
          nullable: true
        employer:
          type: string
          nullable: true
        address1:
          type: string
          nullable: true
        address2:
          type: string
          nullable: true
        city:
          type: string
          nullable: true
        state:
          type: string
          nullable: true
        zip:
          type: string
          nullable: true
        latitude:
          type: number
          nullable: true
        longitude:
          type: number
          nullable: true
        primaryNaics:
          type: string
          nullable: true
        hospitalized:
          type: number
          nullable: true
        amputation:
          type: number
          nullable: true
        lossOfEye:
          type: number
          nullable: true
        inspection:
          type: string
          nullable: true
        finalNarrative:
          type: string
          nullable: true
        nature:
          type: string
          nullable: true
        naturetitle:
          type: string
          nullable: true
        partOfBody:
          type: string
          nullable: true
        partOfBodyTitle:
          type: string
          nullable: true
        event:
          type: string
          nullable: true
        eventtitle:
          type: string
          nullable: true
        source:
          type: string
          nullable: true
        sourcetitle:
          type: string
          nullable: true
        secondarySource:
          type: string
          nullable: true
        secondarySourceTitle:
          type: string
          nullable: true
        federalstate:
          type: string
          nullable: true
        employerId:
          type: string
          nullable: true
          pattern: ^emp_[0-9a-f]{20}$
          description: >-
            Employer Effective matched this row to, or null if it could not
            place it.
        siteId:
          type: string
          nullable: true
          pattern: ^site_[0-9a-f]{20}$
          description: Site Effective matched this row to, or null.
        sourceFile:
          $ref: '#/components/schemas/V2OshaSourceFile'
      required:
        - id
        - upa
        - eventdate
        - employer
        - address1
        - address2
        - city
        - state
        - zip
        - latitude
        - longitude
        - primaryNaics
        - hospitalized
        - amputation
        - lossOfEye
        - inspection
        - finalNarrative
        - nature
        - naturetitle
        - partOfBody
        - partOfBodyTitle
        - event
        - eventtitle
        - source
        - sourcetitle
        - secondarySource
        - secondarySourceTitle
        - federalstate
        - employerId
        - siteId
        - sourceFile
      description: >-
        One severe injury report: a hospitalization, amputation or loss of an
        eye. Fields are OSHA’s own column names in camelCase, with values as
        OSHA publishes them.
    V2Error:
      type: object
      properties:
        error:
          type: string
          minLength: 1
          description: Human-readable explanation of the failure.
      required:
        - error
    V2OshaSourceFile:
      type: object
      properties:
        url:
          type: string
          description: OSHA or DOL file or API page the row was read from.
        sha256:
          type: string
          description: SHA-256 of that file as Effective downloaded it.
        retrievedAt:
          type: string
          description: When Effective downloaded it (RFC 3339).
      required:
        - url
        - sha256
        - retrievedAt
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Effective API key. Send Authorization: Bearer sk-eai-...'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.