> ## 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 case detail

> OSHA ITA case detail from Forms 300 and 301: one row per injury or illness, with the job, outcome and the employer’s own narrative. 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/case-details/{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/case-details/{id}:
    get:
      tags:
        - OSHA
      summary: Get an OSHA case detail
      description: >-
        OSHA ITA case detail from Forms 300 and 301: one row per injury or
        illness, with the job, outcome and the employer’s own narrative. 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: getOshaCaseDetail
      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 case detail.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2OshaCaseDetail'
        '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:
    V2OshaCaseDetail:
      type: object
      properties:
        id:
          type: string
          description: OSHA’s case detail ID.
        establishmentId:
          type: string
          nullable: true
        establishmentName:
          type: string
          nullable: true
        ein:
          type: string
          nullable: true
        companyName:
          type: string
          nullable: true
        streetAddress:
          type: string
          nullable: true
        city:
          type: string
          nullable: true
        state:
          type: string
          nullable: true
        zipCode:
          type: string
          nullable: true
        naicsCode:
          type: string
          nullable: true
        naicsYear:
          type: number
          nullable: true
        industryDescription:
          type: string
          nullable: true
        establishmentType:
          type: number
          nullable: true
        size:
          type: number
          nullable: true
        annualAverageEmployees:
          type: number
          nullable: true
        totalHoursWorked:
          type: number
          nullable: true
        caseNumber:
          type: string
          nullable: true
        jobDescription:
          type: string
          nullable: true
        socCode:
          type: string
          nullable: true
        socDescription:
          type: string
          nullable: true
        socProbability:
          type: number
          nullable: true
        socReviewed:
          type: string
          nullable: true
        unexpectedNaicsSocCombo:
          type: string
          nullable: true
        dateOfIncident:
          type: string
          nullable: true
        incidentOutcome:
          type: number
          nullable: true
        dafwNumAway:
          type: number
          nullable: true
        djtrNumTr:
          type: number
          nullable: true
        typeOfIncident:
          type: number
          nullable: true
        timeStartedWork:
          type: string
          nullable: true
        timeOfIncident:
          type: string
          nullable: true
        timeUnknown:
          type: number
          nullable: true
        dateOfDeath:
          type: string
          nullable: true
        createdTimestamp:
          type: string
          nullable: true
        yearOfFiling:
          type: number
          nullable: true
        yearFilingFor:
          type: number
          nullable: true
        newIncidentLocation:
          type: string
          nullable: true
        newIncidentDescription:
          type: string
          nullable: true
        newNarBeforeIncident:
          type: string
          nullable: true
        newNarWhatHappened:
          type: string
          nullable: true
        newNarInjuryIllness:
          type: string
          nullable: true
        newNarObjectSubstance:
          type: string
          nullable: true
        natureCodePred:
          type: string
          nullable: true
        natureTitlePred:
          type: string
          nullable: true
        partCodePred:
          type: string
          nullable: true
        partTitlePred:
          type: string
          nullable: true
        eventCodePred:
          type: string
          nullable: true
        eventTitlePred:
          type: string
          nullable: true
        sourceCodePred:
          type: string
          nullable: true
        sourceTitlePred:
          type: string
          nullable: true
        secSourceCodePred:
          type: string
          nullable: true
        secSourceTitlePred:
          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
        - establishmentId
        - establishmentName
        - ein
        - companyName
        - streetAddress
        - city
        - state
        - zipCode
        - naicsCode
        - naicsYear
        - industryDescription
        - establishmentType
        - size
        - annualAverageEmployees
        - totalHoursWorked
        - caseNumber
        - jobDescription
        - socCode
        - socDescription
        - socProbability
        - socReviewed
        - unexpectedNaicsSocCombo
        - dateOfIncident
        - incidentOutcome
        - dafwNumAway
        - djtrNumTr
        - typeOfIncident
        - timeStartedWork
        - timeOfIncident
        - timeUnknown
        - dateOfDeath
        - createdTimestamp
        - yearOfFiling
        - yearFilingFor
        - newIncidentLocation
        - newIncidentDescription
        - newNarBeforeIncident
        - newNarWhatHappened
        - newNarInjuryIllness
        - newNarObjectSubstance
        - natureCodePred
        - natureTitlePred
        - partCodePred
        - partTitlePred
        - eventCodePred
        - eventTitlePred
        - sourceCodePred
        - sourceTitlePred
        - secSourceCodePred
        - secSourceTitlePred
        - employerId
        - siteId
        - sourceFile
      description: >-
        One injury or illness case from ITA Form 300 and 301 case detail. 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.