---
title: "Retrieve list of projects for dropdown"
method: GET
path: "/api/v1/projects/list"
tags: ["Projects"]
---

# Retrieve list of projects for dropdown

`GET /api/v1/projects/list`

## Query parameters

- `OrganizationId` integer
- `Search` string
- `CatalogId` integer
- `Healthy` boolean
- `UserId` string
- `Ready` boolean
- `IsBoundToCatalog` boolean

## Response `200`

OK

- CommonDropdownIsBoundDtoForProject[]
  - `id` integer
  - `name` string, nullable
  - `isBound` boolean
  - `hasKubeConfigFile` boolean
  - `kubernetesVersion` string, nullable
  - `isLocked` boolean
  - `maintenanceModeEnabled` boolean
  - `isVirtualCluster` boolean
  - `alertingProfileId` integer, nullable
  - `cloudType` 'AWS' | 'AZURE' | 'GOOGLE' | 'OPENSTACK' | 'PROXMOX' | 'TANZU' | 'OPENSHIFT' | 'VSPHERE' | 'ZADARA' | 'ZEDEDA' | 'EKS' | 'AKS' | 'GKE' | 'GENERICKUBERNETES'
  - `status` 'Null' | 'Deleting' | 'DisableAi' | 'DisableGatekeeper' | 'DeletingBackupPolicies' | 'DisableBackup' | 'DisableMonitoring' | 'EnableBackup' | 'EnableMonitoring' | 'EnableAi' | 'EnableGatekeeper' | 'Failure' | 'FailedUpgrade' | 'Purging' | 'Ready' | 'Updating' | 'Upgrading' | 'UpdatingCredentials' | 'UninstallVirtualCluster' | 'Repairing' | 'Importing' | 'FailedToImport' | 'Migrating'
  - `health` 'Null' | 'Healthy' | 'None' | 'Unhealthy' | 'Unknown' | 'Warning'
  - `importClusterType` 'None' | 'CloudCredential' | 'ReadOnly' | 'FullyManaged'

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `500` — Internal Server Error

---

[API](https://skmtc.dev/taikun/apis/taikun-webapi.md) · [All operations](https://skmtc.dev/taikun/apis/taikun-webapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/taikun/taikun-webapi/revisions/09395964d191/schema)