GET /rest/v1.0/projects/{project_id}/incidents

Returns a list of Incidents for a given project.

Servers

Path parameters

Name Type Required Description
project_id Integer Yes

Unique identifier for the project.

Request headers

Name Type Required Description
Procore-Company-Id Integer Yes

Unique company identifier associated with the Procore User Account.

Query parameters

Name Type Required Description
filters[time_unknown] Boolean No

If true, returns item(s) where the time of Incident occurrence is unknown.

Default value: false

sort String No

Possible values:

  • "contributing_behavior"
  • "hazard"
  • "event_date"
  • "recordable"
  • "title"
  • "contributing_condition"
  • "number"
  • "records_count"
  • "created_at"
filters[created_at] String No

Return item(s) created within the specified ISO 8601 datetime range. Formats: YYYY-MM-DD...YYYY-MM-DD - Date YYYY-MM-DDTHH:MM:SSZ...YYYY-MM-DDTHH:MM:SSZ - DateTime with UTC Offset YYYY-MM-DDTHH:MM:SS+XX:00...YYYY-MM-DDTHH:MM:SS+XX:00` - Datetime with Custom Offset

filters[recordable] Boolean No

Return item(s) that are recordable.

filters[status][] Array No

Returns item(s) matching the specified status value.

filters[location_id][] Array No

Return item(s) with the specified Location IDs.

page Integer No

Page

filters[hazard_id][] Array No

Hazard ID. Returns item(s) with the specified Hazard ID.

filters[id][] Array No

Return item(s) with the specified IDs.

per_page Integer No

Number of items returned per page (Min: 1, Max: 1000). Defaults to 1000 when parameter is not provided.

Default value: 1000

filters[event_date] String No

Returns item(s) with an event date within the specified ISO 8601 datetime range.

filters[updated_at] String No

Return item(s) last updated within the specified ISO 8601 datetime range. Formats: YYYY-MM-DD...YYYY-MM-DD - Date YYYY-MM-DDTHH:MM:SSZ...YYYY-MM-DDTHH:MM:SSZ - DateTime with UTC Offset YYYY-MM-DDTHH:MM:SS+XX:00...YYYY-MM-DDTHH:MM:SS+XX:00 - Datetime with Custom Offset

filters[contributing_behavior_id][] Array No

Contributing Behavior ID. Returns item(s) with the specified Contributing Behavior ID.

filters[contributing_condition_id][] Array No

Contributing Condition ID. Returns item(s) with the specified Contributing Condition ID.

filters[query] String No

Return item(s) containing query. Searchable fields include Incident title, Creator, Witness Statement, Incident Action description, Incident Action Type, Contributing Behavior, Contributing Condition, Hazard, and Location.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.