List Action Plans
list_action_plansRead-onlyIdempotent
Retrieve a paginated list of action plans for a project. Filter by ID, plan type, manager, location, or date ranges.
Instructions
List of all Action Plans. 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/plans
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__include_sublocations | No | Query string parameter — use together with `filters[location_id]` | |
| filters__location_id | No | Query string parameter — location ID. Returns item(s) with the specified Location ID or a range of Location IDs. | |
| filters__manager_id | No | Query string parameter — return item(s) with a specific Manager ID or a range of Manager ID(s). | |
| filters__plan_type_id | No | Query string parameter — action Plan Type ID. Returns item(s) with the specified Action Plan Type ID(s). | |
| filters__template_id | No | Query string parameter — return Action Plan(s) associated with the specified Action Plan Template 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... | |
| sort | No | Query string parameter — direction (asc/desc) can be controlled by the presence or absence of '-' before the sort parameter. |