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.
`filters[assignee_id][]`	Array	No	Return item(s) assigned to the specified User ID.
`filters[status][]`	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`
`filters[location_id][]`	Array	No	Return item(s) with the specified Location IDs.
`filters[trade_ids][]`	Array	No	Array of Trade IDs. Returns item(s) with the specified Trade IDs.
`filters[priority][]`	Array	No	Return item(s) with the specified priorities.
`page`	Integer	No	Page
`filters[type_id][]`	Array	No	Return item(s) with the specified Observation Type ID.
`filters[id][]`	Array	No	Return item(s) with the specified IDs.
`filters[checklist_list_id][]`	Array	No	Array of Checklist List IDs. Return item(s) associated with the specified Checklist List IDs.
`per_page`	Integer	No	Elements per page
`filters[created_by_id][]`	Array	No	Returns item(s) created by the specified User IDs.
`filters[checklist_item_id]`	Integer	No	Return Observations(s) originating from the specified Checklist Item(s).
`filters[search]`	String	No	Return item(s) matching the specified Search query.
`filters[assignee_company_id][]`	Array	No	Array of Vendor IDs. Returns item(s) where the assignee is associated to the specified Vendor ID.
`filters[updated_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

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.