GET /rest/v1.0/task_items

Returns a list of task items on a given project

Servers

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[due_date] String No

Returns item(s) due within the specified ISO 8601 datetime range.

sort String No

Return item(s) with the specified sort.

Valid values:

  • "due_date"
  • "category"
  • "title"
  • "status"
  • "number"
  • "assignee"
filters[assigned_id] String No

Assigned ID

filters[created_at] String No

Return item(s) created 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

filters[status][] Array No

Returns item(s) matching the specified status value.

view String No

Serialization view for each task item in the list. When omitted, defaults to normal.

  • ids_only — JSON array of task item IDs (integers) only; pagination headers still apply.
  • compactid and title only.
  • normal — standard list shape (default).
  • extended — additional fields (e.g. origin, attachments, created_by).

Valid values:

  • "extended"
  • "normal"
  • "compact"
  • "ids_only"
page Integer No

Page

filters[task_item_category_id] String No

Returns item(s) matching the specified Task Item Category ID.

filters[id][] Array No

Return item(s) with the specified IDs.

per_page Integer No

Elements per page

filters[created_by_id][] Array No

Returns item(s) created by the specified User IDs.

filters[query] String No

Return item(s) containing search query

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.