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

# List Projects

`GET /tenants/{tenant_id}/projects`

Returns a list of projects.

---

Projects are returned sorted in descending order based on the created-at time. Without the page and per_page parameters, the first 100 projects will be returned. If per_page is specified, a maximum of 250 projects will be returned.

## Path parameters

- `tenant_id` string, uuid, required

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

Projects successfully retrieved.

- object
  - `projects` object[]
    - `id` string, uuid — Unique ID identifying the project.
    - `name` string — Name of the project.
    - `created_at` string — The timestamp of when the project was created, formatted as "YYYY-MM-DD HH:MM:SS UTC"
    - `property_address` string — Address of the site.
    - `tags` string[] — Tags associated with the project.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[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/revisions/5b41808d104d/schema)