> ## 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 accident investigation

> Accidents OSHA investigated, with OSHA’s description and abstract. Accidents link to workplaces through the inspections that covered the injured workers. 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/accidents/{summaryNr}
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/accidents/{summaryNr}:
    get:
      tags:
        - OSHA
      summary: Get an OSHA accident investigation
      description: >-
        Accidents OSHA investigated, with OSHA’s description and abstract.
        Accidents link to workplaces through the inspections that covered the
        injured workers. 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: getOshaAccident
      parameters:
        - schema:
            type: string
            pattern: ^\d{1,12}$
            description: Accident summary number.
          required: true
          description: Accident summary number.
          name: summaryNr
          in: path
      responses:
        '200':
          description: One accident.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2OshaAccident'
        '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:
    V2OshaAccident:
      type: object
      properties:
        summaryNr:
          type: string
          nullable: true
        reportId:
          type: string
          nullable: true
        eventDate:
          type: string
          nullable: true
        eventTime:
          type: string
          nullable: true
        eventDesc:
          type: string
          nullable: true
        eventKeyword:
          type: string
          nullable: true
        constEndUse:
          type: string
          nullable: true
        buildStories:
          type: string
          nullable: true
        nonbuildHt:
          type: string
          nullable: true
        projectCost:
          type: string
          nullable: true
        projectType:
          type: string
          nullable: true
        sicList:
          type: string
          nullable: true
        fatality:
          type: boolean
          nullable: true
        stateFlag:
          type: string
          nullable: true
        abstractText:
          type: string
          nullable: true
        loadDt:
          type: string
          nullable: true
        id:
          type: string
          description: The accident’s summary number.
        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:
        - summaryNr
        - reportId
        - eventDate
        - eventTime
        - eventDesc
        - eventKeyword
        - constEndUse
        - buildStories
        - nonbuildHt
        - projectCost
        - projectType
        - sicList
        - fatality
        - stateFlag
        - abstractText
        - loadDt
        - id
        - employerId
        - siteId
        - sourceFile
      description: >-
        One accident OSHA investigated. 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.