List Action Plan Items
list_action_plan_itemsRead-onlyIdempotent
List action plan items for a project. Filter results by query, status, assignee, due date, and reference IDs with pagination.
Instructions
Returns all Action Plan Items for a given Project. Use this to enumerate Action Plans when you need a paginated overview, to find IDs, or to filter by query parameters. Returns a paginated JSON array of Action Plans. Use page and per_page to control pagination; the response includes pagination metadata. Required parameters: project_id. Procore API: Project Management > Action Plans. Endpoint: GET /rest/v1.0/projects/{project_id}/action_plans/plan_items
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | URL path parameter — unique identifier for the project. | |
| page | No | Query string parameter — page number for paginated results (default: 1) | |
| per_page | No | Query string parameter — number of items per page (default: 100, max: 100) | |
| filters__created_at | No | Query string parameter — 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__id | No | Query string parameter — return item(s) with the specified IDs. | |
| filters__plan_section_id | No | Query string parameter — return item(s) associated with the specified Action Plan Section(s). | |
| filters__plan_id | No | Query string parameter — return item(s) associated with the specified Action Plan ID(s) | |
| filters__updated_at | No | Query string parameter — 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__query | No | Query string parameter — return item(s) containing search query | |
| filters__due_at | No | Query string parameter — return item(s) due within the specified date range. | |
| filters__assignee_party_id_or_role_id | No | Query string parameter — return item(s) associated with the specified Action Plan Assignee party ID(s) or role ID(s) | |
| filters__attachment_id | No | Query string parameter — return item(s) associated with the specified Action Plan reference attachment ID(s) | |
| filters__drawing_revision_id | No | Query string parameter — return item(s) associated with the specified Action Plan reference drawing revision ID(s) | |
| filters__file_version_id | No | Query string parameter — return item(s) associated with the specified Action Plan reference file version ID(s) | |
| filters__plan_test_record_request_id | No | Query string parameter — return item(s) associated with the specified Action Plan Test Record Request ID(s). | |
| filters__specification_section_id | No | Query string parameter — return item(s) associated with the specified Action Plan reference specification section id ID(s) | |
| filters__verification_method_id | No | Query string parameter — return item(s) associated with the specified Action Plan Assignee verification method ID(s) | |
| filters__generic_tool_item_id | No | Query string parameter — return item(s) associated with the specified Action Plan reference Generic Tool Item ID(s) | |
| filters__form_id | No | Query string parameter — return item(s) associated with the specified Action Plan reference Form ID(s) | |
| filters__meeting_id | No | Query string parameter — return item(s) associated with the specified Action Plan reference Meeting ID(s) | |
| filters__observation_item_id | No | Query string parameter — return item(s) associated with the specified Action Plan reference Observation Item ID(s) | |
| filters__submittal_log_id | No | Query string parameter — return item(s) associated with the specified Action Plan reference submittal log ID(s) | |
| filters__record_checklist_template_id | No | Query string parameter — return item(s) with the specified checklist template id. | |
| filters__record_generic_tool_id | No | Query string parameter — return item(s) with the specified Generic Tool ID. | |
| filters__reference_type | No | Query string parameter — return item(s) associated with the specified Action Plan reference type(s) | |
| filters__status_id | No | Query string parameter — array of Status IDs. A single Status ID is also accepted. |