---
title: "List Projects"
method: POST
path: "/api/v2/deployments/{deploymentId}/projects/list"
tags: ["ProjectsService"]
---

# List Projects

`POST /api/v2/deployments/{deploymentId}/projects/list`

List all projects based on provided filters.

## Path parameters

- `deploymentId` string, required — Your deployment ID.

## Request body

- ProtosProjectsV2ListProjectsRequest
  - `pageSize` integer — Maximum number of projects to return in a single page.
  - `pageToken` string — Opaque cursor used for pagination. If not provided the first page will be returned.
  - `filter` ProtosProjectsV2ProjectsFilter — Optionally apply filters to which projects should be returned.
    - `assignedToTeams` boolean — When `true`, returns projects that have one or more NON-DEFAULT teams assigned. When `false`, returns projects that only have DEFAULT teams or have no teams at all. If not specified, projects will not be filtered by teams.
    - `names` string[] — Only return projects whose name matches any of the given substrings. If not specified, projects will not be filtered by name.
    - `statuses` string[] — Only return projects matching one of the specified statuses. If not specified, projects will not be filtered by status. | value | description | |-------|---------------| | PROJECT_STATUS_SETUP | Represents a scanning or otherwise fully-initialized project. | | PROJECT_STATUS_NOT_SETUP | Represents a project that is neither fully-initialized nor scanning (e.g. is only inferred from an SCM sync). Archived projects are not included in this status. | | PROJECT_STATUS_ARCHIVED | Represents a project that has been archived. |

## Response `200`

OK

- ProtosProjectsV2ListProjectsResponse
  - `projects` ProtosProjectsV2Project[] — The list of projects.
    - `id` integer — The unique identifier for the project.
    - `name` string — The name of the project. Usually the name of the repository.
    - `createTime` string, date-time — When this project was first set up.
    - `tags` string[] — The tags that have been applied to this project.
    - `latestScanId` integer — The most-recent started scan on this project.
    - `url` string — The URL for this project.
    - `primaryBranchId` string — The ID of the primary branch of the project, if known. Get more details about the branch from [Get Branch](#tag/ProjectsService/operation/ProjectsService_GetBranch).
    - `defaultBranchId` string — The ID of default branch as retrieved from the source code manager. Get more details about the branch from [Get Branch](#tag/ProjectsService/operation/ProjectsService_GetBranch).
  - `pageToken` string — An opaque cursor used to paginate through the results.

---

[API](https://skmtc.dev/semgrep/apis/semgrep-web-app.md) · [All operations](https://skmtc.dev/semgrep/apis/semgrep-web-app/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/semgrep/semgrep-web-app/revisions/6483eeecd582/schema)