Project Folder And File Index
project_folder_and_file_indexRead-onlyIdempotent
List all folders and files in a Procore project using project_id. Supports pagination and filters for document types, creators, and dates.
Instructions
Return a list of all folders and files in the project. Use this to read information about Documents from Procore. Returns a paginated JSON array of Documents. Use page and per_page to control pagination; the response includes pagination metadata. Required parameters: project_id. Procore API (v2.0): Core > Documents. Endpoint: GET /rest/v2.0/projects/{project_id}/documents
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | URL path parameter — unique identifier for the project. | |
| view | No | Query string parameter — determines how much information to include in the response. `normal` is the default, `extended` provides additional data. The example below shows the `extended` response. | |
| sort | No | Query string parameter — field to sort by. If the field is passed with a - (EX: -updated_at) it is sorted in reverse order | |
| filters__created_by_id | No | Query string parameter — return item(s) created by the specified User IDs | |
| 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__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__document_type | No | Query string parameter — return item(s) that are file or folder | |
| filters__file_type | No | Query string parameter — return item(s) that have the file extensions | |
| filters__is_in_recycle_bin | No | Query string parameter — return item(s) that are in or not in the recycle bin | |
| filters__search | No | Query string parameter — returns item(s) matching the specified search query string. | |
| filters__folder_id | No | Query string parameter — returns the folder for a given id with all subfolders and subfiles up to a depth of 100. Depths greater than 100 will need multiple queries to get all children. | |
| filters__custom_tag_ids | No | Query string parameter — return item(s) with specified custom tag IDs | |
| filters__private | No | Query string parameter — if true, returns only item(s) with a `private` status. | |
| 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) |