List Incident Alerts
list_incident_alertsRetrieve a paginated list of incident alerts for a Procore project. Filter by incident ID to find specific alerts or obtain an ID for subsequent operations.
Instructions
Returns a paginated list of all incident alerts for the specified project. Optionally scope to a single incident by providing incident_id. Use this to discover incident alerts 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 incident alerts; 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/alerts
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Query string parameter — page number for paginated results (default: 1) | |
| sort | No | Query string parameter — sort results by the specified field. | |
| per_page | No | Query string parameter — number of items per page (default: 100, max: 100) | |
| project_id | Yes | URL path parameter — unique identifier for the project. | |
| filters__id | No | Query string parameter — return item(s) with the specified IDs. | |
| incident_id | No | Query string parameter — unique identifier of the incident | |
| filters__injury_id | No | Query string parameter — return item(s) with the specified Injury IDs. | |
| 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__incident_id | No | Query string parameter — return item(s) with the specified Incident IDs. | |
| filters__recipient_id | No | Query string parameter — return item(s) with the specified recipient (User) IDs | |
| filters__filing_type_id | No | Query string parameter — return item(s) with the specified Incident Filing Type IDs. | |
| filters__triggered_by_id | No | Query string parameter — return item(s) with the specified triggered by (User) IDs | |
| filters__severity_level_id | No | Query string parameter — return item(s) with the specified Incident Severity Level IDs |