List Company Project Status Snapshots
list_company_project_status_snapshotsRead-onlyIdempotent
Retrieve a paginated list of company-level project status snapshots from Procore Budget views, with filtering by project, status, program, and more, and sorted by creation date.
Instructions
Returns a paginated list of company-level Project Status snapshots with optional filtering and sorting. Use this to enumerate Budget records when you need a paginated overview, to find IDs, or to filter by query parameters. Returns a paginated JSON array of Budget records. Use page and per_page to control pagination; the response includes pagination metadata. Required parameters: company_id, budget_view_id. Procore API (v2.0): Construction Financials > Budget. Endpoint: GET /rest/v2.0/companies/{company_id}/budget_views/{budget_view_id}/project_status_snapshots
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| company_id | Yes | URL path parameter — unique identifier for the company. | |
| budget_view_id | Yes | URL path parameter — iD of the budget view | |
| filters__status_id | No | Query string parameter — filter snapshots by PSS custom status ID | |
| filters__project_id | No | Query string parameter — filter snapshots by project ID | |
| filters__program_id | No | Query string parameter — filter snapshots by program ID | |
| filters__region_id | No | Query string parameter — filter snapshots by region ID | |
| filters__stage_id | No | Query string parameter — filter snapshots by stage ID | |
| filters__office_id | No | Query string parameter — filter snapshots by office ID | |
| filters__department_id | No | Query string parameter — filter snapshots by department ID | |
| filters__created_by_id | No | Query string parameter — filter snapshots by created_by_id | |
| filters__created_at | No | Query string parameter — filter snapshots by created_at date range, inclusive | |
| sort | No | Query string parameter — sort order for results. Prefix with '-' for descending order | |
| 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) |