list_projects_v1_1
Retrieve and filter construction projects from Procore by status, name, date, or custom fields to manage project portfolios efficiently.
Instructions
List projects. [Core/Portfolio] GET /rest/v1.1/projects
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| company_id | Yes | Unique identifier for the company. | |
| page | No | Page | |
| per_page | No | Elements per page | |
| filters__by_status | No | Filters on project status. Must be one of Active, Inactive, or All. | |
| filters__name | No | Filters projects to those matching the given string. | |
| filters__project_number | No | Filters on project number. | |
| filters__created_at | 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-... | |
| filters__updated_at | 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 `YYY... | |
| filters__origin_id | No | Origin ID. Returns item(s) with the specified Origin ID. | |
| filters__id | No | Return item(s) with the specified IDs. | |
| filters__synced | No | If true, returns only item(s) with a `synced` status. | |
| filters__vendor_id | No | Return item(s) with the specified Vendor ID. | |
| filters__is_demo | No | Filters on project is_demo attribute, which indicates whether project is for demonstration purposes. | |
| filters__custom_fields | No | JSON object returns project with matching custom_field_values | |
| filters__template | No | Filters on project template attribute, which indicates whether project is a template | |
| filters__by_owner_type | No | Return item(s) with the specified project owner type ID(s). | |
| filters__by_department | No | Return item(s) with the specified department ID(s). | |
| filters__by_region | No | Return item(s) with the specified project region ID(s). | |
| filters__by_office | No | Return item(s) with the specified office ID(s). | |
| filters__by_program | No | Return item(s) with the specified project program ID(s). | |
| filters__by_stage | No | Return item(s) with the specified project stage ID(s). | |
| filters__by_type | No | Return item(s) with the specified project type ID(s). | |
| filters__by_bid_type | No | Return item(s) with the specified project bid type ID(s). | |
| view | No | The view determines which fields are returned. 'ids' return only id as an Integer (it additionally influences 'per_page' value to be strictly 200000), 'compact' returns only id and name, 'normal' r... | |
| sort | No | Return items with the specified sort. |