---
title: "Lists projects that an authenticated user is a member of."
method: GET
path: "/api/v1/projects"
tags: ["project"]
---

# Lists projects that an authenticated user is a member of.

`GET /api/v1/projects`

## Request

- The document declares no server URL.
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/kubermatic/apis/kubermatic-kubernetes-platform-api/docs/api/v1/projects/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `displayAll` boolean

## Response `200`

Project

- Project[]
  - `annotations` object: Annotations that can be added to the resource
  - `clustersNumber` integer
  - `creationTimestamp` string, date-time: CreationTimestamp is a timestamp representing the server time when this object was created.
  - `deletionTimestamp` string, date-time: DeletionTimestamp is a timestamp representing the server time when this object was deleted.
  - `id` string: ID unique value that identifies the resource generated by the server. Read-Only.
  - `labels` object
  - `name` string: Name represents human readable name for the resource
  - `owners` User[]: Owners an optional owners list for the given project
    - `annotations` object: Annotations that can be added to the resource
    - `creationTimestamp` string, date-time: CreationTimestamp is a timestamp representing the server time when this object was created.
    - `deletionTimestamp` string, date-time: DeletionTimestamp is a timestamp representing the server time when this object was deleted.
    - `email` string: Email an email address of the user
    - `id` string: ID unique value that identifies the resource generated by the server. Read-Only.
    - `isAdmin` boolean: IsAdmin indicates admin role
    - `name` string: Name represents human readable name for the resource
    - `projects` ProjectGroup[]: Projects holds the list of project the user belongs to along with the group names
      - `group` string
      - `id` string
    - `userSettings` UserSettings: UserSettings represent an user settings
      - `collapseSidenav` boolean
      - `displayAllProjectsForAdmin` boolean
      - `itemsPerPage` integer
      - `lastSeenChangelogVersion` string
      - `selectProjectTableView` boolean
      - `selectedProjectId` string
      - `selectedTheme` string
  - `status` string

## Other responses

- `401`: EmptyResponse is a empty response
- `409`: EmptyResponse is a empty response
- `default`: errorResponse

---

[API](https://skmtc.dev/kubermatic/apis/kubermatic-kubernetes-platform-api.md) - [All operations](https://skmtc.dev/kubermatic/apis/kubermatic-kubernetes-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kubermatic/apis/kubermatic-kubernetes-platform-api/revisions/815b9bf19db5?raw)