List Incidents
list_incidentsRead-onlyIdempotent
Retrieve a paginated list of incidents for a project. Filter by date, status, location, and more to find specific incidents.
Instructions
Returns a list of Incidents for a given project. Use this to enumerate Incidents when you need a paginated overview, to find IDs, or to filter by query parameters. Returns a paginated JSON array of Incidents. Use page and per_page to control pagination; the response includes pagination metadata. Required parameters: project_id. Procore API: Project Management > Incidents. Endpoint: GET /rest/v1.0/projects/{project_id}/incidents
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | URL path parameter — unique identifier for the project. | |
| page | No | Query string parameter — page number for paginated results (default: 1) | |
| per_page | No | Query string parameter — number of items returned per page (Min: 1, Max: 1000). Defaults to 1000 when parameter is not provided. | |
| filters__id | No | Query string parameter — return item(s) with the specified IDs. | |
| 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__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__event_date | No | Query string parameter — returns item(s) with an event date within the specified ISO 8601 datetime range. | |
| filters__location_id | No | Query string parameter — return item(s) with the specified Location IDs. | |
| filters__status | No | Query string parameter — returns item(s) matching the specified status value. | |
| 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. | |
| filters__hazard_id | No | Query string parameter — hazard ID. Returns item(s) with the specified Hazard ID. | |
| filters__time_unknown | No | Query string parameter — if true, returns item(s) where the time of Incident occurrence is unknown. | |
| filters__recordable | No | Query string parameter — return item(s) that are recordable. | |
| filters__custom_status_id | No | Query string parameter — return item(s) with the specified Custom Status IDs | |
| filters__type_id | No | Query string parameter — return item(s) with a specific Type ID or a range of Type IDs. | |
| filters__assignee_id | No | Query string parameter — return item(s) with a specific Assignee ID or a range of Assignee IDs. | |
| filters__query | No | Query string parameter — return item(s) containing query. Searchable fields include Incident title, Creator, Witness Statement, Incident Action description, Incident Action Type, Contributing Behavior, Contributing Conditi... | |
| sort | No | Query string parameter — sort order for results. Prefix with '-' for descending order |