---
title: "List projects"
method: GET
path: "/cloud/v1/projects"
tags: ["Projects"]
---

# List projects

`GET /cloud/v1/projects`

Retrieve a list of projects for a client.
Results can be filtered by name and ordered by various fields.

## Query parameters

- `include_deleted` boolean — Whether to include deleted projects in the response.
- `limit` integer — Limit value is used to limit the number of records in the result
- `name` string — Name to filter the results by.
- `offset` integer — Offset value is used to exclude the first set of records from the result
- `order_by` 'created_at.asc' | 'created_at.desc' | 'name.asc' | 'name.desc'

## Response `200`

OK

- ListProjectsSerializer
  - `count` integer, required — Number of objects
  - `results` ProjectSerializer[], required — Objects
    - `client_id` integer, required — ID associated with the client.
    - `created_at` string, date-time, required — Datetime of creation, which is automatically generated.
    - `deleted_at` string, date-time, nullable, required — Datetime of deletion, which is automatically generated if the project is deleted.
    - `description` string, nullable, required — Description of the project.
    - `id` integer, required — Project ID, which is automatically generated upon creation.
    - `is_default` boolean, required — Indicates if the project is the default one. Each client always has one default project.
    - `name` string, required — Unique project name for a client.
    - `state` string, required — The state of the project.
    - `task_id` string, nullable, required — The UUID of the active task that currently holds a lock on the resource. This lock prevents concurrent modifications to ensure consistency. If `null`, the resource is not locked.

---

[API](https://skmtc.net/g-core/apis/gcore-openapi.md) · [All operations](https://skmtc.net/g-core/apis/gcore-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/g-core/gcore-openapi/revisions/09e652815095/schema)