List Near Misses
list_near_missesList near miss records for a project, optionally scoped to an incident, to review hazard details and get record IDs for further actions.
Instructions
Returns a paginated list of near miss records for the specified project, optionally scoped to a single incident via incident_id. Each near miss includes description, affected person, harm source, potential for injury details, and custom fields. By default sorted by descending full_number (incident.number). Supports filtering by affected party, harm source, managed equipment, and full-text search. Use this to discover near misses 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 near misses; 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/near_misses
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 per page (default: 100, max: 100) | |
| project_id | Yes | URL path parameter — unique identifier for the project. | |
| incident_id | No | Query string parameter — optional incident ID to scope results. When provided, returns only near miss records belonging to the specified incident. Omit to retrieve near misses across all incidents in the project. | |
| filters__query | No | Query string parameter — full-text search across near miss description and related fields. Returns near misses where any searchable field contains the query string. | |
| 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__harm_source_id | No | Query string parameter — array of Harm Source IDs. Returns item(s) with the specified Harm Source IDs. | |
| filters__work_activity_id | No | Query string parameter — array of Work Activity IDs. Returns item(s) with the specified Work Activity IDs. | |
| filters__affected_party_id | No | Query string parameter — array of Affected Party IDs. Returns item(s) with the specified Affected Party IDs. | |
| filters__affected_person_id | No | Query string parameter — array of Person IDs. Returns item(s) with the specified affected Person IDs. | |
| filters__affected_company_id | No | Query string parameter — array of Company IDs. Returns item(s) with the specified affected Company IDs. | |
| filters__managed_equipment_id | No | Query string parameter — return item(s) with the specified Managed Equipment ID. |