---
title: "Get Project Summary"
method: GET
path: "/api/v1/projects/{project_id}/summary"
tags: ["summary"]
---

# Get Project Summary

`GET /api/v1/projects/{project_id}/summary`

## Path parameters

- `project_id` string, uuid, required

## Query parameters

- `sheets` string[], nullable
- `include_hidden_layers` boolean
- `group_by` 'condition' | 'bid_area' | 'zone'
- `rev` string, uuid, nullable

## Response `200`

Successful Response

- SummaryResponse
  - `items` SummaryCondition[], required
    - `condition_id` string, uuid, required
    - `name` string, required
    - `color` string, required
    - `geometry_kind` 'count' | 'linear' | 'area', required
    - `shape` 'circle' | 'square' | 'rectangle', nullable
    - `notes` string, nullable
    - `phase_code` PhaseCodeRef — The phase code assigned to a condition, denormalized onto the row.
      - `id` string, uuid, required
      - `code` string, required
      - `description` string, required
    - `folder_id` string, uuid, nullable
    - `folder_name` string, nullable
    - `sort_order` number, required
    - `layer_id` string, uuid, required
    - `layer_hidden` boolean, required
    - `condition_hidden` boolean, required
    - `dimensions` Dimensions — Geometric parameters. Field meaning depends on (geometry_kind, shape). Count + Circle/Square: width_in = diameter/side; height_in = vertical extrusion. Count + Rectangle: width_in = x footprint; thickness_in = y footprint; height_in = vertical extrusion. Linear: height_in (vertical face), thickness_in (material thickness), slope. Area: thickness_in (material thickness), slope. Per ADR-0040 and docs/superpowers/specs/2026-05-27-condition-render-dims-design.md §3.1. Values are decimal inches (ADR-0091); pre-existing integer payloads coerce.
      - `width_in` number, nullable
      - `thickness_in` number, nullable
      - `height_in` number, nullable
      - `slope` string, nullable
    - `measurement_count` integer, required
    - `pending_count` integer
    - `derivations` SummaryDerivation[]
      - `ordinal` integer, required
      - `result_type` 'count' | 'total_height' | 'perimeter' | 'surface_area_top_or_bottom' | 'surface_area_top_and_bottom' | 'surface_area_all_sides' | 'surface_area_full' | 'volume' | 'length' | 'segment_count' | 'surface_area_single_side' | 'surface_area_both_sides' | 'surface_area_single_end' | 'surface_area_both_ends' | 'surface_area_all_side_duct' | 'area' | 'grid_length_visible' | 'grid_length_x_visible' | 'grid_length_y_visible' | 'grid_intersection_count' | 'tile_count_average' | 'tile_count_visible' | 'area_counts', required
      - `uom` 'EA' | 'LF' | 'IN' | 'FT' | 'SF' | 'SY' | 'CF' | 'CY', required
      - `value` number, required
      - `base_value` number, required
      - `factor_min` number, required
      - `factor_max` number, required
    - `bid_area_id` string, uuid, nullable
    - `bid_area_path` string, nullable
    - `zone_id` string, uuid, nullable
    - `zone_name` string, nullable
    - `trace_groups` TraceGroup[], nullable
      - `name` string, nullable
      - `measurement_count` integer, required
      - `pending_count` integer
      - `derivations` SummaryDerivation[]
        - `ordinal` integer, required
        - `result_type` 'count' | 'total_height' | 'perimeter' | 'surface_area_top_or_bottom' | 'surface_area_top_and_bottom' | 'surface_area_all_sides' | 'surface_area_full' | 'volume' | 'length' | 'segment_count' | 'surface_area_single_side' | 'surface_area_both_sides' | 'surface_area_single_end' | 'surface_area_both_ends' | 'surface_area_all_side_duct' | 'area' | 'grid_length_visible' | 'grid_length_x_visible' | 'grid_length_y_visible' | 'grid_intersection_count' | 'tile_count_average' | 'tile_count_visible' | 'area_counts', required
        - `uom` 'EA' | 'LF' | 'IN' | 'FT' | 'SF' | 'SY' | 'CF' | 'CY', required
        - `value` number, required
        - `base_value` number, required
        - `factor_min` number, required
        - `factor_max` number, required
  - `total_conditions_in_project` integer, required
  - `hidden_condition_count` integer, required
  - `sheet_count` integer, required
  - `filtered_sheet_count` integer, required

## Other responses

- `4XX` — Client Error
- `5XX` — Server Error

---

[API](https://skmtc.dev/rudus/apis/rudus-api.md) · [All operations](https://skmtc.dev/rudus/apis/rudus-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rudus/rudus-api/revisions/f149124a4d80/schema)