List Observation Items
list_observation_itemsRead-onlyIdempotent
Retrieve a paginated list of observation items for a project. Filter by status, assignee, location, or other criteria.
Instructions
Returns a collection of Observation Items. See Filtering on List Actions for information on using the filtering capabilities provided by this endpoint. Use this to enumerate Observations when you need a paginated overview, to find IDs, or to filter by query parameters. Returns a paginated JSON array of Observations. Use page and per_page to control pagination; the response includes pagination metadata. Required parameters: project_id. Procore API: Project Management > Observations. Endpoint: GET /rest/v1.0/observations/items
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filters__assignee_company_id | No | Query string parameter — array of Vendor IDs. Returns item(s) where the assignee is associated to the specified Vendor ID. | |
| filters__checklist_list_id | No | Query string parameter — array of Checklist List IDs. Return item(s) associated with the specified Checklist List IDs. | |
| filters__created_by_id | No | Query string parameter — returns item(s) created by the specified User IDs. | |
| filters__id | No | Query string parameter — return item(s) with the specified IDs. | |
| filters__location_id | No | Query string parameter — return item(s) with the specified Location IDs. | |
| filters__assignee_id | No | Query string parameter — return item(s) assigned to the specified User ID. | |
| filters__checklist_item_id | No | Query string parameter — return Observations(s) originating from the specified Checklist Item(s). | |
| filters__priority | No | Query string parameter — return item(s) with the specified priorities. | |
| filters__search | No | Query string parameter — return item(s) matching the specified Search query. | |
| filters__status | No | Query string parameter — return item(s) with the specified status values. The mapping is as follows: ``` 0: Initiated 1: Ready For reviewed 2: Not Accepted 3: Closed ``` | |
| filters__type_id | No | Query string parameter — return item(s) with the specified Observation Type ID. | |
| filters__trade_ids | No | Query string parameter — array of Trade IDs. Returns item(s) with the specified Trade 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... | |
| project_id | Yes | Query string 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 per page (default: 100, max: 100) |