---
title: "List Cases"
method: GET
path: "/incidents/v1/osha/cases"
tags: ["OSHA"]
---

# List Cases

`GET /incidents/v1/osha/cases`

## Request

- Base URL: `https://api.mitti.com`
- URL: `https://api.mitti.com/incidents/v1/osha/cases`
- Auth: HTTP bearer

## Query parameters

- `page_size` integer, required
- `page_token` string
- `page_number` integer
- `search` string
- `establishment_id` string
- `year_of_filing` integer

## Response `200`

A successful response.

- S12IncidentsV1ListCasesResponse: ListCasesResponse is the response message for listing OSHA cases.
  - `results` S12IncidentsV1Case[]: results is the list of case records.
    - `case_id` string: case_id is the unique identifier for the case.
    - `establishment_id` string: establishment_id is the ID of the establishment this case belongs to.
    - `created_at` string, date-time: created_at is the timestamp when the case was created.
    - `modified_at` string, date-time: modified_at is the timestamp when the case was last modified.
    - `created_by` S12IncidentsV1UserMeta
      - `user_id` string: unique identifier for the user
      - `display_name` string: name of the user
      - `profile_image` S12CommonMedia
        - `id` string
        - `token` string
        - `filename` string: full file name, including file extension
        - `media_type` 'MEDIA_TYPE_IMAGE' | 'MEDIA_TYPE_VIDEO' | 'MEDIA_TYPE_PDF' | 'MEDIA_TYPE_DOCX' | 'MEDIA_TYPE_XLSX' | 'MEDIA_TYPE_PPTX' | 'MEDIA_TYPE_CSV': - MEDIA_TYPE_IMAGE: An image file (GIF, JPG, PNG, WEBP). - MEDIA_TYPE_VIDEO: A video file (MP4, MOV). - MEDIA_TYPE_PDF: A PDF document. - MEDIA_TYPE_DOCX: A Microsoft Word document (DOCX, DOC). - MEDIA_TYPE_XLSX: A Microsoft Excel spreadsheet (XLSX, XLS). - MEDIA_TYPE_PPTX: A Microsoft PowerPoint presentation (PPTX, PPT). - MEDIA_TYPE_CSV: A CSV file.
      - `email` string: email address of the user
      - `seat_type` 'SUBSCRIPTION_SEAT_TYPE_UNSPECIFIED' | 'SUBSCRIPTION_SEAT_TYPE_PREMIUM' | 'SUBSCRIPTION_SEAT_TYPE_COLLABORATOR' | 'SUBSCRIPTION_SEAT_TYPE_LITE' | 'SUBSCRIPTION_SEAT_TYPE_SERVICE_USER' | 'SUBSCRIPTION_SEAT_TYPE_SUPPORT'
      - `status` 'USER_ACTIVE_STATUS_UNSPECIFIED' | 'USER_ACTIVE_STATUS_ACTIVE' | 'USER_ACTIVE_STATUS_DEACTIVATED': - USER_ACTIVE_STATUS_UNSPECIFIED: Status is unknown or not specified - USER_ACTIVE_STATUS_ACTIVE: User is active - USER_ACTIVE_STATUS_DEACTIVATED: User has been deactivated
      - `timezone` string: the timezone of the user
    - `modified_by` S12IncidentsV1UserMeta
      - `user_id` string: unique identifier for the user
      - `display_name` string: name of the user
      - `profile_image` S12CommonMedia
        - `id` string
        - `token` string
        - `filename` string: full file name, including file extension
        - `media_type` 'MEDIA_TYPE_IMAGE' | 'MEDIA_TYPE_VIDEO' | 'MEDIA_TYPE_PDF' | 'MEDIA_TYPE_DOCX' | 'MEDIA_TYPE_XLSX' | 'MEDIA_TYPE_PPTX' | 'MEDIA_TYPE_CSV': - MEDIA_TYPE_IMAGE: An image file (GIF, JPG, PNG, WEBP). - MEDIA_TYPE_VIDEO: A video file (MP4, MOV). - MEDIA_TYPE_PDF: A PDF document. - MEDIA_TYPE_DOCX: A Microsoft Word document (DOCX, DOC). - MEDIA_TYPE_XLSX: A Microsoft Excel spreadsheet (XLSX, XLS). - MEDIA_TYPE_PPTX: A Microsoft PowerPoint presentation (PPTX, PPT). - MEDIA_TYPE_CSV: A CSV file.
      - `email` string: email address of the user
      - `seat_type` 'SUBSCRIPTION_SEAT_TYPE_UNSPECIFIED' | 'SUBSCRIPTION_SEAT_TYPE_PREMIUM' | 'SUBSCRIPTION_SEAT_TYPE_COLLABORATOR' | 'SUBSCRIPTION_SEAT_TYPE_LITE' | 'SUBSCRIPTION_SEAT_TYPE_SERVICE_USER' | 'SUBSCRIPTION_SEAT_TYPE_SUPPORT'
      - `status` 'USER_ACTIVE_STATUS_UNSPECIFIED' | 'USER_ACTIVE_STATUS_ACTIVE' | 'USER_ACTIVE_STATUS_DEACTIVATED': - USER_ACTIVE_STATUS_UNSPECIFIED: Status is unknown or not specified - USER_ACTIVE_STATUS_ACTIVE: User is active - USER_ACTIVE_STATUS_DEACTIVATED: User has been deactivated
      - `timezone` string: the timezone of the user
    - `year_of_filing` integer: year_of_filing is the year this case is filed for.
    - `case_number` string: case_number is the case number.
    - `job_title` string: job_title is the job title of the affected employee.
    - `date_of_incident` string, date-time: date_of_incident is the date the incident occurred.
    - `incident_location` string: incident_location is where the incident occurred.
    - `incident_description` string: incident_description is description of the incident.
    - `incident_outcome` integer: incident_outcome is the outcome of the incident (1=Death, 2=Days away, 3=Job transfer, 4=Other).
    - `dafw_num_away` integer: dafw_num_away is days away from work.
    - `djtr_num_tr` integer: djtr_num_tr is days job transfer or restriction.
    - `type_of_incident` integer: type_of_incident is the type of incident (1=Injury, 2=Skin disorder, 3=Respiratory, 4=Poisoning, 5=Hearing loss, 6=Other).
    - `date_of_birth` string, date-time: date_of_birth is the employee's date of birth.
    - `date_of_hire` string, date-time: date_of_hire is the employee's date of hire.
    - `sex` string: sex is the employee's sex (M or F).
    - `treatment_facility_type` integer: treatment_facility_type is whether emergency room was used (1=yes, 0=no).
    - `treatment_in_patient` integer: treatment_in_patient is whether hospitalization was required (1=yes, 0=no).
    - `time_started_work` string: time_started_work is time employee began work (hh:mm format).
    - `time_of_incident` string: time_of_incident is time of incident (hh:mm format).
    - `time_unknown` boolean: time_unknown is whether time of incident is unknown.
    - `nar_before_incident` string: nar_before_incident is what employee was doing before incident.
    - `nar_what_happened` string: nar_what_happened is how injury/illness occurred.
    - `nar_injury_illness` string: nar_injury_illness is what the injury/illness was.
    - `nar_object_substance` string: nar_object_substance is object/substance that harmed employee.
    - `date_of_death` string, date-time: date_of_death is the date of death if applicable.
    - `employee_name` string: employee_name is the name of the employee.
    - `employee_street_address` string: employee_street_address is the street address of the employee.
    - `employee_city` string: employee_city is the city where the employee resides.
    - `employee_state` string: employee_state is the two-letter state code for the employee.
    - `employee_zip` string: employee_zip is the ZIP code for the employee.
    - `physician_name` string: physician_name is the name of the physician who treated the employee.
    - `facility_name` string: facility_name is the name of the treatment facility.
    - `facility_street_address` string: facility_street_address is the street address of the treatment facility.
    - `facility_city` string: facility_city is the city where the treatment facility is located.
    - `facility_state` string: facility_state is the two-letter state code for the treatment facility.
    - `facility_zip` string: facility_zip is the ZIP code for the treatment facility.
  - `next_page_token` string: next_page_token is a token which can be used to fetch further results (for pagination).

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/safetyculture/apis/safetyculture-api.md) - [All operations](https://skmtc.dev/safetyculture/apis/safetyculture-api/llms.txt) - [OpenAPI document](https://skmtc.dev/safetyculture/apis/safetyculture-api/revisions/eb6bb843bf18?raw)
