---
title: "List Designs"
method: GET
path: "/tenants/{tenant_id}/projects/{id}/designs"
tags: ["Designs"]
---

# List Designs

`GET /tenants/{tenant_id}/projects/{id}/designs`

Returns a list of designs.

---

Designs are returned sorted in descending order based on creation date.

## Path parameters

- `tenant_id` string, uuid, required
- `id` string, uuid, required

## Response `200`

Designs successfully retrieved.

- object
  - `designs` object[]
    - `id` string, uuid — Unique ID identifying the design.
    - `external_provider_id` string — Unique ID of design provided by external provider.
    - `name` string — Name of the design.
    - `created_at` string — The timestamp of when the design was created, formatted as "YYYY-MM-DD HH:MM:SS UTC"
    - `system_size_ac` number, double — Size of design in Watts (AC)
    - `system_size_ptc` number, double — Size of design in Watts (DC, PTC)
    - `system_size_stc` number, double — Size of design in Watts (DC, STC)
    - `milestone` object, nullable — The latest milestone for the design. Null if no milestone has been set.
      - `id` string, uuid — Unique ID identifying the milestone.
      - `milestone` 'offer' | 'sold' | 'installed' | 'permission_to_operate' | 'change_order' | 'revised' | 'canceled' — The milestone of the design
      - `notes` string — Notes for the milestone
      - `recorded_at` string, date-time — The timestamp of when the milestone was recorded in UTC.
      - `canceled_from_milestone` 'offer' | 'sold' | 'installed' | 'permission_to_operate' | 'change_order' | 'revised', nullable — The milestone before the design was marked canceled. Null if the current milestone is not canceled.
      - `change_order_types` string[] — Reasons for the change order. Empty unless milestone is "change_order".

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/aurorasolar/apis/sync-api.md) · [All operations](https://skmtc.net/aurorasolar/apis/sync-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aurorasolar/sync-api/versions/5b41808d104d/schema)