GET /rest/v2.0/companies/{company_id}/projects/{project_id}/workflows/instances

Returns a list of workflow instances for a given project.

Servers

Path parameters

Name Type Required Description
project_id String Yes

Unique identifier for the project.

company_id String Yes

Unique identifier for the company.

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
filtersactive Boolean No

Return only instances that are active.

filterstool_type String Yes

Filter instances with matching tool type.

per_page Integer No

Elements per page

Default value: 10

filtersoverdue Boolean No

Return only instances whose next workflow step is overdue.

filtersassignee_id String No

Filter instances with matching current assignee.

filterstool_subtype Integer No

Filter instances by tool subtype. Required when tool_type is 'correspondence'.

filtersitem_id String No

Filter instances with matching item id.

cursor String No

Cursor location where the returned list of items are before or after this cursor location.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. 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.
  3. Click Test request to test run your request to the API and see the API's response.