DOL OSHA ITA Case Data API Specifications

Department of Labor 

Occupational Safety and Health Administration

(OSHA)
DOL OSHA ITA Case Data API Specifications P a g e | 2

2 1 TTable of Contents 3 1 T DOL OSHA ITA Case Data API Specifications13 T ..................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................................1

Document Change Log ....................................................................................................................3

Introduction ......................................................................................................................................4

New Endpoints Introduced in v3.0.................................................................................................5

Changes to Existing Endpoints .....................................................................................................5

Authentication...............................................................................................................................5

Data Dictionary ................................................................................................................................6

API Endpoint - Add Case Data .........................................................................................................8

Details ..........................................................................................................................................8

Sample Request .......................................................................................................................8

Sample Response.....................................................................................................................9

API Endpoint - Get Case Data By ID..............................................................................................10

Details ........................................................................................................................................10

Sample Response...................................................................................................................10

API Endpoint - Get Case Data by Establishment ID........................................................................11

Details ........................................................................................................................................11

Sample Response...................................................................................................................11

API Endpoint - Edit Case Data .......................................................................................................13

Details ........................................................................................................................................13

Sample Request .....................................................................................................................13

Sample Response...................................................................................................................14

API Endpoint – Complete Submission............................................................................................15

Details ........................................................................................................................................15

Sample Request .....................................................................................................................15

Sample Response...................................................................................................................15

API Endpoint - Get Case Data by Submission Id............................................................................17

Details ........................................................................................................................................17

Sample Response...................................................................................................................17
DOL OSHA ITA Case Data API Specifications P a g e | 3

Document Change Log

Version Date Details

DRAFT 6-23-2023 Initial draft of the specifications

1.0 7-5-2023 Approved by OSHA business team

1.1 8-25-2023 Added incident_description field

Changed emp_gender to gender

1.2 10-31-2023 Changed gender field to not be required
DOL OSHA ITA Case Data API Specifications P a g e | 4

Introduction

The Department of Labor (DOL) Occupational Safety and Health Administration (OSHA) Injury 

Tracking Application (ITA) provides a system to securely access and submit information related to 

workplace injuries. The application is being enhanced for reporting year 2024 (collection of CY 2023 

data) to begin collecting details on individual injury and illness cases.

To facilitate this process, ITA provides a utility to bulk upload larger data sets usingAPI endpoints. API 

data submission will continue to accept form 300A data and will extend this capability to forms 300 

and 301 for the upcoming reporting period. Organizations that have been using API post requests to 

upload case summary data in the past will continue to follow the same process to post form 300A 

data. Going forward, additional API endpoints will be provided to upload, view and edit form 300 and 

301 data. This document outlines the specifications for the new data collection.

The existing API specification used to submit form 300A data will retain the same structure without 

modification. The implementation of new API endpoints minimizes the number of impacted end users 

adopting the new submission process for forms 300 and 301.

REMINDER: Please do not include any personally identifiable information (PII) pertaining to worker(s) 

involved in the incident (e.g., no names, phone numbers, or SSNs) in the narrative fields.
DOL OSHA ITA Case Data API Specifications P a g e | 5

New Endpoints Introduced in v3.0

The table below gives the list of the new endpoints introduced in the OSHA ITA API in the v3.0

release.

Endpoint HTTP

Metho 

d

Endpoint URL

Add Case Data POST /oshaApi/v1/forms/caseData

Get Case Data by

Id

GET /oshaAPi/v1/forms/caseData/{caseDataId}

Get Case Data by

Establishment Id

GET /oshaAPi/v1/forms/caseData/establishment/{establishmentI

d}

Edit Case Data PATCH /oshaApi/v1/forms/caseData/{caseDataId}

Get Case Data by

Submission Id

GET /oshaApi/v1/submissions/{submissionId}

Changes to Existing Endpoints

The following end points already exist in the current application, but the behaviors will change for 

establishments that have case data. These end points will behave exactly as they are behaving 

currently for establishments that do not have any case data for backward compatibility with existing 

applications that do not have case data submissions.

Endpoint HTTP

Metho

d

Endpoint URL

Complete 

Submission 

(submit summary 

and case details) 

for an

establishment

POST /oshaApi/v1/submissions

Authentication

The authentication mechanism for the new API endpoints will be the same as for existing endpoints.
DOL OSHA ITA Case Data API Specifications P a g e | 6

Data Dictionary

These are the fields that make up the body of most of the Request API calls involving the Case Data 

form. Additional fields that are specific to a given call will be detailed inline.

Data Element Definition and

Validations

Format Length Required

to 

CREATE

Required

to EDIT

Id System Generated Integer N/A No Yes

case_number Case number from your 

Log. The case number

must be unique.

Character 100 Yes No

job_title Job title Character 255 Yes No

date_of_incident Date employee was

injured or became ill. 

Example: 06-29-2022.

mm-ddyyyy or 

mm/dd/yyyy

10 Yes No

incident_location Where the event occurred Character 255 Yes No

incident_description Brief description about the 

incident

Character 255 Yes No

incident_outcome Incident outcome

Enter 1 for Death

Enter 2 for Days away 

from work

Enter 3 for Job transfer or 

restricted work activity 

Enter 4 for Other 

recordable cases

Integer 1 Yes No

dafw_num_away If 2 is set on

incident_outcome, Days 

away from work

Integer 3 No No

djtr_num_tr If 2 or 3 is set on 

incident_outcome,

Days away or job transfer

or restriction

Integer 3 No No

type_of_incident Type of Incident

1 for Injury

2 for Skin disorder,

3 for Respiratory condition

4 for Poisoning

5 for Hearing loss

6 for other illnesses

Integer 1 Yes No

date_of_birth Date of Birth.

Example: 06-29-2022.

mm-ddyyyy or 

mm/dd/yyyy

10 Yes No

date_of_hire Date employee was hired.

Example: 06-29-2022.

mm-ddyyyy or 

mm/dd/yyyy

10 Yes No

gender Employee's gender

M for male

F for female

Character 1 No No

treatment_facility_type Was employee treated in

emergency room? 

1 for yes

Integer 1 Yes No
DOL OSHA ITA Case Data API Specifications P a g e | 7

Data Element Definition and

Validations

Format Length Required

to 

CREATE

Required

to EDIT

0 for no

treatment_in_patient Was employee

hospitalized as an inpatient?

1 for yes

0 for no

Integer 1 Yes No

time_started_work Time employee began

work in24-hour time. 

Example: 17:30.

Time

(hh:mm)

5 No No

time_of_incident Time of event in 24-hour

time. Example: 17:30.

Time

(hh:mm)

5 No No

time_unknown Time is unknown

Set to 1 if time is unknown

Int 1 No No

nar_before_incident What was employee

doing just before the 

incident occurred?

Text N/A Yes No

nar_what_happened What happened? Tell us

how the injury or illness 

occurred

Text N/A Yes no

nar_injury_illness What was the injury or 

illness?

Text N/A Yes No

nar_object_substance What object or substance

directly harmed the 

employee?

Text N/A Yes No

date_of_death If employee died, date of

death. Example: 06-29-

2022.

mm-ddyyyy or 

mm/dd/yyyy

10 No No
DOL OSHA ITA Case Data API Specifications P a g e | 8

API Endpoint - Add Case Data

To add Case data to an establishment, you will need to make a POST request to the ITA service with 

the authorization header set to the API token that belongs to your account. You will also need to 

include a valid Case data JSON object with the embedded establishment object's ID or name set to 

the establishment you are trying to create the entry for.

To add Case data to multiple establishments, you will need to include a JSON body of an array of 

valid Case data JSON objects, with their embedded establishment objects having an ID or name set 

to the establishment that the data is for.

Details

URL : https://www.osha.gov/oshaApi/v1/forms/caseData

Action: POST

Header : Authorization Bearer [ITA API Token]

Sample Request

{

"establishment": {

"id": "1234567",

"establishment_name": "Store 1"

},

"case_number": "CS-1617", 

"job_title": "Manager", 

"date_of_incident": "07-18-2022", 

"incident_location": "Location",

"incident_description": "Brief description", 

"incident_outcome": "1", // Refer the data dictionary 

"dafw_num_away": "1",

"djtr_num_tr": "2",

"type_of_incident": "1", // Refer the data dictionary

"date_of_birth": "06-23-1998",

"date_of_hire": "03-15-2022", 

"gender": "F", 

"treatment_facility_type": "0",

"treatment_in_patient": "0",

"time_started_work": "08:00",

"time_of_incident": "09:20",

"time_unknown": "0",

"nar_before_incident": "Lorem ipsum dolor sit amet.", 

"nar_what_happened": "Lorem ipsum dolor sit amet.", 

"nar_injury_illness": "Lorem ipsum dolor sit amet.", 

"nar_object_substance": "Lorem ipsum dolor sit amet.", 

"date_of_death": "07-22-2022"

}
DOL OSHA ITA Case Data API Specifications P a g e | 9

Sample Response

{

"results": [

{

"id": "987654",

"establishment_id": "1234567",

"year_filing_for ": "2023", 

"case_number": "CS-1617", 

"job_title": "Manager", 

"date_of_incident": "07-18-2022", 

"incident_location": "Location",

"incident_description": "Brief description", 

"incident_outcome": "1", // Refer the data dictionary 

"dafw_num_away": "1",

"djtr_num_tr": "2",

"type_of_incident": "1", // Refer the data dictionary

"date_of_birth": "06-23-1998",

"date_of_hire": "03-15-2022", 

"gender": "F", 

"treatment_facility_type": "0",

"treatment_in_patient": "0",

"time_started_work": "08:00",

"time_of_incident": "09:20",

"time_unknown": "0",

"nar_before_incident": "Lorem ipsum dolor sit amet.", 

"nar_what_happened": "Lorem ipsum dolor sit amet.", 

"nar_injury_illness": "Lorem ipsum dolor sit amet.", 

"nar_object_substance": "Lorem ipsum dolor sit amet.", 

"date_of_death": "07-22-2022",

"links": {

"self": "/oshaApi/v1/forms/caseData/987654", 

"establishment": "/oshaApi/v1/establishments/1234567"

}

}],

"success": true

}
DOL OSHA ITA Case Data API Specifications P a g e | 10

API Endpoint - Get Case Data By ID

To get Case data for an establishment by the ID of the specific caseData item, you will need to make 

a GET request to the ITA service with the authorization header set to the API token that belongs to your 

account. You will also need to include the ID at the end of the request URL that belongs to the specific 

Form 301 case data you are trying to retrieve.

Details

URL : https://www.osha.gov/oshaAPi/v1/forms/caseData/{caseDataId}

Action: GET

Header : Authorization Bearer [ITA API Token]

Sample Response

{

"results": [

{

"id": "456789",

"establishment_id": "2345678",

"year_filing_for ": "2016", 

"case_number": "CS-1617", 

"job_title": "Manager", 

"date_of_incident": "07-18-2022", 

"incident_location": "Location",

"incident_description": "Brief description", 

"incident_outcome": "1", // Refer the data dictionary 

"dafw_num_away": "1",

"djtr_num_tr": "2",

"type_of_incident": "1", // Refer the data dictionary

"date_of_birth": "06-23-1998",

"date_of_hire": "03-15-2022", 

"gender": "F", 

"treatment_facility_type": "0",

"treatment_in_patient": "0",

"time_started_work": "08:00",

"time_of_incident": "09:20",

"time_unknown": "0",

"nar_before_incident": "Lorem ipsum dolor sit amet.", 

"nar_what_happened": "Lorem ipsum dolor sit amet.", 

"nar_injury_illness": "Lorem ipsum dolor sit amet.", 

"nar_object_substance": "Lorem ipsum dolor sit amet.", 

"date_of_death": "07-22-2022",

"links": {

"self": "/oshaApi/v1/forms/caseData/987654", 

"establishment": "/oshaApi/v1/establishments/2345678"

}

}],

"success": true

}
DOL OSHA ITA Case Data API Specifications P a g e | 11

API Endpoint - Get Case Data by Establishment ID

Details

URL : https://www.osha.gov/oshaAPi/v1/forms/caseData/establishment/{establishmentId}

Action: GET

Header : Authorization Bearer [ITA API Token]

Sample Response

{

"results": [

{

"id": "456789",

"case_number": "CS-1617", 

"job_title": "Manager", 

"date_of_incident": "07-18-2022", 

"incident_location": "Location",

"incident_description": "Brief description", 

"incident_outcome": "1", // Refer the data dictionary 

"dafw_num_away": "1",

"djtr_num_tr": "2",

"type_of_incident": "1", // Refer the data dictionary

"date_of_birth": "06-23-1998",

"date_of_hire": "03-15-2022", 

"gender": "F", 

"treatment_facility_type": "0",

"treatment_in_patient": "0",

"time_started_work": "08:00",

"time_of_incident": "09:20",

"time_unknown": "0",

"nar_before_incident": "Lorem ipsum dolor sit amet.", 

"nar_what_happened": "Lorem ipsum dolor sit amet.", 

"nar_injury_illness": "Lorem ipsum dolor sit amet.", 

"nar_object_substance": "Lorem ipsum dolor sit amet.", 

"date_of_death": "07-22-2022",

"links": {

"self": "/oshaApi/v1/forms/caseData/456789", 

"establishment": "/oshaApi/v1/establishments/2345678"

}

},

{

"id": "456790",

"case_number": "CS-1617", 

"job_title": "Manager", 

"date_of_incident": "07-18-2022", 

"incident_location": "Location",

"incident_description": "Brief description", 

"incident_outcome": "1", // Refer the data dictionary 

"dafw_num_away": "1",

"djtr_num_tr": "2",

"type_of_incident": "1", // Refer the data dictionary

"date_of_birth": "06-23-1998",
DOL OSHA ITA Case Data API Specifications P a g e | 12

"date_of_hire": "03-15-2022", 

"gender": "F", 

"treatment_facility_type": "0",

"treatment_in_patient": "0",

"time_started_work": "08:00",

"time_of_incident": "09:20",

"time_unknown": "0",

"nar_before_incident": "Lorem ipsum dolor sit amet.", 

"nar_what_happened": "Lorem ipsum dolor sit amet.", 

"nar_injury_illness": "Lorem ipsum dolor sit amet.", 

"nar_object_substance": "Lorem ipsum dolor sit amet.", 

"date_of_death": "07-22-2022",

"links": {

"self": "/oshaApi/v1/forms/caseData/456790", 

"establishment": "/oshaApi/v1/establishments/2345678"

}

}],

"success": true

}
DOL OSHA ITA Case Data API Specifications P a g e | 13

API Endpoint - Edit Case Data

To edit Case data for a specific submission, you will need to make a PATCH request to the ITA

Service with the authorization header set to the API token that belongs to your account. You will also 

need to include the ID at the end of the URL request that belongs to the specific Case Data 

submission you are trying to edit. You will also need to include a JSON body that includes the ID of 

the Form 300A you are trying to edit, as well as the field or fields with the edited information.

To edit Case data for several establishments, you will need to include a JSON body with an array of 

objects each containing the ID of the Case Data Submission you want to edit, as well as the specific 

field or fields you want to edit.

Details

URL : https://www.osha.gov/oshaApi/v1/forms/caseData/{caseDataId}

Action: PATCH

Header : Authorization Bearer [ITA API Token]

Sample Request

{

"id ": "456790",

"case_number": "CS-1617", 

"job_title": "Manager", 

"date_of_incident": "07-18-2022", 

"incident_location": "Location",

"incident_description": "Brief description", 

"incident_outcome": "1", // Refer the data dictionary 

"dafw_num_away": "1",

"djtr_num_tr": "2",

"type_of_incident": "1", // Refer the data dictionary

"date_of_birth": "06-23-1998",

"date_of_hire": "03-15-2022", 

"gender": "F", 

"treatment_facility_type": "0",

"treatment_in_patient": "0",

"time_started_work": "08:00",

"time_of_incident": "09:20",

"time_unknown": "0",

"nar_before_incident": "Lorem ipsum dolor sit amet.", 

"nar_what_happened": "Lorem ipsum dolor sit amet.", 

"nar_injury_illness": "Lorem ipsum dolor sit amet.", 

"nar_object_substance": "Lorem ipsum dolor sit amet.", 

"date_of_death": "07-22-2022"

}
DOL OSHA ITA Case Data API Specifications P a g e | 14

Sample Response

{

"results": [

{

"id": "456790",

"establishment_id": "1234567",

"year_filing_for": "2023", 

"case_number": "CS-1617", 

"job_title": "Manager", 

"date_of_incident": "07-18-2022", 

"incident_location": "Location",

"incident_description": "Brief description", 

"incident_outcome": "1", // Refer the data dictionary 

"dafw_num_away": "1",

"djtr_num_tr": "2",

"type_of_incident": "1", // Refer the data dictionary

"date_of_birth": "06-23-1998",

"date_of_hire": "03-15-2022", 

"gender": "F", 

"treatment_facility_type": "0",

"treatment_in_patient": "0",

"time_started_work": "08:00",

"time_of_incident": "09:20",

"time_unknown": "0",

"nar_before_incident": "Lorem ipsum dolor sit amet.", 

"nar_what_happened": "Lorem ipsum dolor sit amet.", 

"nar_injury_illness": "Lorem ipsum dolor sit amet.", 

"nar_object_substance": "Lorem ipsum dolor sit amet.", 

"date_of_death": "07-22-2022"

"links": {

"self": "/oshaApi/v1/forms/caseData/987654", 

"establishment": "/oshaApi/v1/establishments/1234567"

}

}],

"success": true

}
DOL OSHA ITA Case Data API Specifications P a g e | 15

API Endpoint – Complete Submission

To complete the submission for an establishment, you will need to make a POST request to the ITA 

Service with the authorization header set to the API token that belongs to your account.

This is an existing end point and this marks the submission of all the data for the given establishment. 

This would include the form 300A summary as well as all the case data that has been submitted for the

establishment. For establishments that do not have any case data this will behave exactly like in the 

past and the response will not have the caseData property set. For those establishments that do have

case data, this property will be set in the response.

Details

URL : https://www.osha.gov/oshaApi/v1/submissions

Action: POST

Header : Authorization Bearer [ITA API Token]

Sample Request

{

"establishment_id": "2345678",

"year_filing_for": "2016",

"change_reason": "Reason for resubmission, if applicable"

}

Sample Response

{

"results": [

{

"id": "900800",

"year_filing_for ": "2016", 

"establishment": {

... see results field of Establishment response object.

},

"form300A": {

... see results field of Form 300A response object.

},

"caseData": [

"/oshaApi/v1/forms/caseData/{caseDataId}", 

"/oshaApi/v1/forms/caseData/{caseDataId}",

.

.

.

"/oshaApi/v1/forms/caseData/{caseDataId}"

}],

],

"created_username": "joesample", 

"time_stamp": 1687595329, 

"links": {

"self": "/oshaApi/v1/submissions/1",

"establishment": "/oshaApi/v1/establishments/2345678", 

"form300A: "/oshaApi/v1/forms/form300A/1"
DOL OSHA ITA Case Data API Specifications P a g e | 16

"success": true

}
DOL OSHA ITA Case Data API Specifications P a g e | 17

API Endpoint - Get Case Data by Submission Id

To get a specific submission, you will need to make a GET request to the ITA service with the

authorization header set to the API token that belongs to your account. You will also need to

include the ID of the submission at the end of the URL request.

This is an existing end point. The end point will behave exactly like it used to for establishments 

that do not have any case data submissions. For those that do have case data submissions, the 

response will have the caseData property set. For those that do not have case data 

submissions it will not have the caseData property set.

Details

URL : https://www.osha.gov/oshaApi/v1/submissions/{submissionId}

Action: GET

Header : Authorization Bearer [ITA API Token]

Sample Response

{

"results": [

{

"id": "900800",

"year_filing_for ": "2016", 

"establishment": {

... see results field of Establishment response object

},

"form300A": {

... see results field of Form 300A Response Object

},

"caseData": {

"/oshaApi/v1/forms/caseData/{caseDataId}", 

"/oshaApi/v1/forms/caseData/{caseDataId}",

.

.

.

"/oshaApi/v1/forms/caseData/{caseDataId}"

},

"created_username": "joesample", 

"time_stamp": 1487125329, 

"links": {

"self": "/oshaApi/v1/submissions/1",

"establishment": "/oshaApi/v1/establishments/2345678", 

"form300A: "/oshaApi/v1/forms/form300A/1"

}

}],

"success": true

}
DOL OSHA ITA Case Data API Specifications P a g e | 18

REMINDER: Please do not include any personally identifiable information (PII) pertaining to 

worker(s) involved in the incident (e.g., no names, phone numbers, or SSNs) in the narrative 

fields.