List Incident Alerts
list_incident_alertsRead-onlyIdempotent
Retrieve paginated incident alerts from a project. Filter by ID, injury, recipient, severity, or trigger for targeted results.
Instructions
Returns a list of all Incident Alerts associated with a 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/alerts
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | URL path parameter — unique identifier for the project. | |
| incident_id | No | Query string parameter — unique identifier of the incident | |
| page | No | Query string parameter — page number for paginated results (default: 1) | |
| per_page | No | Query string parameter — number of items per page (default: 100, max: 100) | |
| filters__id | No | Query string parameter — return item(s) with the specified 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__injury_id | No | Query string parameter — return item(s) with the specified Injury IDs. | |
| filters__recipient_id | No | Query string parameter — return item(s) with the specified recipient (User) IDs | |
| filters__severity_level_id | No | Query string parameter — return item(s) with the specified Incident Severity Level IDs | |
| filters__triggered_by_id | No | Query string parameter — return item(s) with the specified triggered by (User) IDs | |
| sort | No | Query string parameter — sort order for results. Prefix with '-' for descending order |