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

# Get an OSHA severe injury report

> 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. Needs the OSHA dataset enabled for your organization. Read-only; private, no-store. 



## OpenAPI

````yaml /openapi.json get /insurance/osha/severe-injury-reports/{id}
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.canary.effectiveai.app/api/v2
    description: Canary
security:
  - bearerAuth: []
paths:
  /insurance/osha/severe-injury-reports/{id}:
    get:
      tags:
        - OSHA
      summary: Get an OSHA severe injury report
      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. Needs the OSHA dataset
        enabled for your organization. Read-only; private, no-store. 
      operationId: getOshaSevereInjuryReport
      parameters:
        - schema:
            type: string
            pattern: ^[A-Za-z0-9_-]{1,40}$
            description: OSHA’s ID for the row.
          required: true
          description: OSHA’s ID for the row.
          name: id
          in: path
      responses:
        '200':
          description: One severe injury report.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2OshaSevereInjuryReport'
        '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:
    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.
    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
    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
    V2Error:
      type: object
      properties:
        error:
          type: string
          minLength: 1
          description: Human-readable explanation of the failure.
      required:
        - error
  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.