> ## 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 Form 300A summary

> OSHA Injury Tracking Application (ITA) Form 300A summaries: one establishment’s yearly injury and illness totals, hours worked and headcount. 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/300a-summaries/{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/300a-summaries/{id}:
    get:
      tags:
        - OSHA
      summary: Get an OSHA Form 300A summary
      description: >-
        OSHA Injury Tracking Application (ITA) Form 300A summaries: one
        establishment’s yearly injury and illness totals, hours worked and
        headcount. 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: getOsha300aSummary
      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 Form 300A summary.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2Osha300aSummary'
        '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:
    V2Osha300aSummary:
      type: object
      properties:
        id:
          type: string
          description: OSHA’s summary ID.
        establishmentName:
          type: string
          nullable: true
        establishmentId:
          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
        noInjuriesIllnesses:
          type: number
          nullable: true
        totalDeaths:
          type: number
          nullable: true
        totalDafwCases:
          type: number
          nullable: true
        totalDjtrCases:
          type: number
          nullable: true
        totalOtherCases:
          type: number
          nullable: true
        totalDafwDays:
          type: number
          nullable: true
        totalDjtrDays:
          type: number
          nullable: true
        totalInjuries:
          type: number
          nullable: true
        totalSkinDisorders:
          type: number
          nullable: true
        totalRespiratoryConditions:
          type: number
          nullable: true
        totalPoisonings:
          type: number
          nullable: true
        totalHearingLoss:
          type: number
          nullable: true
        totalOtherIllnesses:
          type: number
          nullable: true
        createdTimestamp:
          type: string
          nullable: true
        changeReason:
          type: string
          nullable: true
        yearFilingFor:
          type: number
          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
        - establishmentName
        - establishmentId
        - ein
        - companyName
        - streetAddress
        - city
        - state
        - zipCode
        - naicsCode
        - naicsYear
        - industryDescription
        - establishmentType
        - size
        - annualAverageEmployees
        - totalHoursWorked
        - noInjuriesIllnesses
        - totalDeaths
        - totalDafwCases
        - totalDjtrCases
        - totalOtherCases
        - totalDafwDays
        - totalDjtrDays
        - totalInjuries
        - totalSkinDisorders
        - totalRespiratoryConditions
        - totalPoisonings
        - totalHearingLoss
        - totalOtherIllnesses
        - createdTimestamp
        - changeReason
        - yearFilingFor
        - employerId
        - siteId
        - sourceFile
      description: >-
        One establishment’s ITA Form 300A summary for one year. 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.