List Harm Sources
list_harm_sourcesRetrieve a paginated list of harm sources for a company to identify hazards. Use it to look up harm source IDs before reporting incidents.
Instructions
Returns a paginated list of harm sources for the specified company. Harm sources identify the material, substance, or object that caused or could cause harm in an incident. Use this to discover harm sources or to look up the id of one before calling a tool that needs it. company_id defaults to the value set by procore_set_config when omitted. Returns a JSON array of harm sources; 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: company_id. Procore API: Project Management > Incidents. Endpoint: GET /rest/v1.0/companies/{company_id}/incidents/harm_sources
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| all | No | Query string parameter — when true, returns both active and inactive harm sources. When omitted or false, returns only active harm sources. | |
| page | No | Query string parameter — page number for paginated results (default: 1) | |
| sort | No | Query string parameter — sort direction. Use the value to sort ascending, or prefix with a hyphen (e.g. -name) to sort descending. | |
| per_page | No | Query string parameter — number of items per page (default: 100, max: 100) | |
| company_id | Yes | URL path parameter — unique identifier for the company. | |
| filters__id | No | Query string parameter — return item(s) with the specified IDs. | |
| filters__active | No | Query string parameter — if true, returns item(s) with a status of 'active'. | |
| 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... |