List Calendar Items
list_calendar_itemsRead-onlyIdempotent
Retrieve paginated calendar items for a project. Use filters and sorting to find schedule records by date, assignee, or query.
Instructions
Returns all Calendar Items for a given project. Use this to enumerate Schedule (Legacy) records when you need a paginated overview, to find IDs, or to filter by query parameters. Returns a paginated JSON array of Schedule (Legacy) records. Use page and per_page to control pagination; the response includes pagination metadata. Required parameters: project_id. Procore API: Project Management > Schedule (Legacy). Endpoint: GET /rest/v1.0/projects/{project_id}/schedule/calendar_items
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | URL path parameter — unique identifier for the project. | |
| view | No | Query string parameter — the view to use when serializing Calendar Item data. The ids_only view returns an array of Calendar Item IDs. The total_count_only view returns total count of Calendar Items. | |
| start_date | No | Query string parameter — calendar Items that occur after this date | |
| finish_date | No | Query string parameter — calendar Items that occur before this date | |
| 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__query | No | Query string parameter — return item(s) containing search query | |
| 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__assigned_id | No | Query string parameter — returns task(s) with specified assignee(s) | |
| filters__date | No | Query string parameter — returns task(s) existing on the specified ISO 8601 datetime | |
| sort | No | Query string parameter — return item(s) with the specified sort. Prepend "-" to specify descending order. |