GET /rest/v1.0/observations/items

Returns a collection of Observation Items. See Filtering on List Actions for information on using the filtering capabilities provided by this endpoint.

Servers

https://api.procore.com

Request headers

Name	Type	Required	Description
`Procore-Company-Id`	Integer	Yes	Unique company identifier associated with the Procore User Account.

Query parameters

Name	Type	Required	Description
`project_id`	Integer	Yes	Unique identifier for the project.
`filterstrade_ids[]`	Array	No	Array of Trade IDs. Returns item(s) with the specified Trade IDs.
`filterspriority[]`	Array	No	Return item(s) with the specified priorities.
`filterslocation_id[]`	Array	No	Return item(s) with the specified Location IDs.
`filtersassignee_company_id[]`	Array	No	Array of Vendor IDs. Returns item(s) where the assignee is associated to the specified Vendor ID.
`page`	Integer	No	Page
`filterstype_id[]`	Array	No	Return item(s) with the specified Observation Type ID.
`filtersstatus[]`	Array	No	Return item(s) with the specified status values. The mapping is as follows: `0: Initiated 1: Ready For reviewed 2: Not Accepted 3: Closed`
`per_page`	Integer	No	Elements per page
`filtersassignee_id[]`	Array	No	Return item(s) assigned to the specified User ID.
`filterschecklist_item_id`	Integer	No	Return Observations(s) originating from the specified Checklist Item(s).
`filterssearch`	String	No	Return item(s) matching the specified Search query.
`filtersupdated_at`	String	No	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 `YYYY-MM-DDTHH:MM:SS+XX:00`...`YYYY-MM-DDTHH:MM:SS+XX:00` - Datetime with Custom Offset
`filterscreated_by_id[]`	Array	No	Returns item(s) created by the specified User IDs.
`filterschecklist_list_id[]`	Array	No	Array of Checklist List IDs. Return item(s) associated with the specified Checklist List IDs.
`filtersid[]`	Array	No	Return item(s) with the specified IDs.

How to start integrating

Add HTTP Task to your workflow definition.
Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
Click Test request to test run your request to the API and see the API's response.