List Incidents
list_incidentsList incidents for a project with filters for date, location, status, and full-text search to locate specific incidents or obtain their IDs.
Instructions
Returns a paginated list of incidents for the specified project, ordered by descending number by default. Each incident includes summary information, associated records count, and linked resources (location, contributing factors, assignees). Supports filtering by date, location, status, root cause fields, recordable flag, and full-text search across title, creator, witness statements, actions, and related fields. Use filters[query] for keyword search. Use this to discover incidents or to look up the id of one before calling a tool that needs it. project_id defaults to the value set by procore_set_config when omitted. Returns a JSON array of incidents; page and per_page control pagination and the response reports how many pages remain. Read-only — it changes nothing in Procore. Failures come back as an error payload carrying the HTTP status — commonly 401 when the token has expired, 403 without tool permission, and 404 when an id does not resolve. Required parameters: project_id. Procore API: Project Management > Incidents. Endpoint: GET /rest/v1.0/projects/{project_id}/incidents
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Query string parameter — page number for paginated results (default: 1) | |
| sort | No | Query string parameter — sort order for results. Prefix with '-' for descending order | |
| per_page | No | Query string parameter — number of items returned per page (Min: 1, Max: 1000). Defaults to 1000 when parameter is not provided. | |
| project_id | Yes | URL path parameter — unique identifier for the project. | |
| filters__id | No | Query string parameter — return item(s) with the specified IDs. | |
| filters__query | No | Query string parameter — full-text search across incident title, creator name, witness statements, action descriptions, action types, contributing behaviors, contributing conditions, hazards, and location names. Returns in... | |
| filters__status | No | Query string parameter — returns item(s) matching the specified status value. | |
| filters__type_id | No | Query string parameter — return item(s) with a specific Type ID or a range of Type IDs. | |
| filters__hazard_id | No | Query string parameter — hazard ID. Returns item(s) with the specified Hazard ID. | |
| filters__created_at | No | Query string parameter — 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-... | |
| filters__event_date | No | Query string parameter — returns item(s) with an event date within the specified ISO 8601 datetime range. | |
| filters__recordable | No | Query string parameter — return item(s) that are recordable. | |
| filters__updated_at | No | Query string parameter — 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 `YYY... | |
| filters__assignee_id | No | Query string parameter — return item(s) with a specific Assignee ID or a range of Assignee IDs. | |
| filters__location_id | No | Query string parameter — return item(s) with the specified Location IDs. | |
| filters__time_unknown | No | Query string parameter — if true, returns item(s) where the time of Incident occurrence is unknown. | |
| filters__custom_status_id | No | Query string parameter — return item(s) with the specified Custom Status IDs | |
| filters__contributing_behavior_id | No | Query string parameter — contributing Behavior ID. Returns item(s) with the specified Contributing Behavior ID. | |
| filters__contributing_condition_id | No | Query string parameter — contributing Condition ID. Returns item(s) with the specified Contributing Condition ID. |