> ## 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.

# List OSHA Form 300A summaries

> 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. Newest first. To page, repeat the same filters and limit with cursor set to nextCursor. Read one with GET /insurance/osha/300a-summaries/{id}. Needs the OSHA dataset enabled for your organization. Read-only; private, no-store. 



## OpenAPI

````yaml /openapi.json get /insurance/osha/300a-summaries
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:
    get:
      tags:
        - OSHA
      summary: List OSHA Form 300A summaries
      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. Newest
        first. To page, repeat the same filters and limit with cursor set to
        nextCursor. Read one with GET /insurance/osha/300a-summaries/{id}. Needs
        the OSHA dataset enabled for your organization. Read-only; private,
        no-store. 
      operationId: listOsha300aSummaries
      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
            minLength: 1
            maxLength: 40
            description: OSHA ITA establishment ID.
          required: false
          description: OSHA ITA establishment ID.
          name: establishmentId
          in: query
        - schema:
            type: string
            pattern: ^\d{2}-?\d{7}$
            description: EIN as filed, with or without the dash.
          required: false
          description: EIN as filed, with or without the dash.
          name: ein
          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{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
            pattern: ^\d{4}$
            description: >-
              Filing year (OSHA’s yearFilingFor): the calendar year the cases
              happened in.
          required: false
          description: >-
            Filing year (OSHA’s yearFilingFor): the calendar year the cases
            happened in.
          name: year
          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 Form 300A summaries.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2Osha300aSummaries'
        '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:
    V2Osha300aSummaries:
      type: object
      properties:
        summaries:
          type: array
          items:
            $ref: '#/components/schemas/V2Osha300aSummary'
        nextCursor:
          type: string
          nullable: true
          description: Cursor for the next page, or null on the last page.
      required:
        - summaries
        - 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
    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.
    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.