---
title: "Get a list of all projects."
method: GET
path: "/api/admin/projects"
tags: ["Projects"]
---

# Get a list of all projects.

`GET /api/admin/projects`

This endpoint returns an list of all the projects in the Unleash instance.

## Query parameters

- `archived` boolean

## Response `200`

projectsSchema

- ProjectsSchema — An overview of all the projects in the Unleash instance
  - `version` integer, required — The schema version used to represent the project data.
  - `projects` ProjectSchema[], required — A list of projects in the Unleash instance
    - `id` string, required — The id of this project
    - `name` string, required — The name of this project
    - `description` string, nullable — Additional information about the project
    - `health` number — Use `technicalDebt` instead.
    - `technicalDebt` number — An indicator of the [project's technical debt](https://docs.getunleash.io/concepts/technical-debt#project-status) on a scale from 0 to 100
    - `featureCount` number — The number of features this project has
    - `staleFeatureCount` number — The number of stale features this project has
    - `potentiallyStaleFeatureCount` number — The number of potentially stale features this project has
    - `memberCount` number — The number of members this project has
    - `createdAt` string, date-time — When this project was created.
    - `updatedAt` string, date-time, nullable — When this project was last updated.
    - `lastUpdatedAt` string, date-time, nullable — When this project was last updated.
    - `archivedAt` string, date-time, nullable — When this project was archived.
    - `favorite` boolean — `true` if the project was favorited, otherwise `false`.
    - `mode` 'open' | 'protected' | 'private' — The project's [collaboration mode](https://docs.getunleash.io/concepts/project-collaboration-mode). Determines whether non-project members can submit change requests or not.
    - `defaultStickiness` string — A default stickiness for the project affecting the default stickiness value for variants and Gradual Rollout strategy
    - `avgTimeToProduction` number — The average time from when a feature was created to when it was enabled in the "production" environment during the current window
    - `lastReportedFlagUsage` string, date-time, nullable — Across all flags in your project this is the last time usage metrics where reported from connected applications.
    - `owners` union — The users and/or groups that have the "owner" role in this project. If no such users or groups exist, the list will contain the "system" owner instead.
      - union[]
        - union
          - object
            - `ownerType` 'user', required
            - `name` string, required
            - `imageUrl` string, nullable
            - `email` string, nullable
          - object
            - `ownerType` 'group', required
            - `name` string, required
      - object[]
        - `ownerType` 'system', required

## Other responses

- `401` — Authorization information is missing or invalid. Provide a valid API token as the `authorization` header, e.g. `authorization:*.*.my-admin-token`.
- `403` — The provided user credentials are valid, but the user does not have the necessary permissions to perform this operation

---

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