---
title: "Lists access control projects."
method: GET
path: "/api/projects"
tags: ["Projects", "GradleEnterprise", "Develocity"]
---

# Lists access control projects.

`GET /api/projects`

## Request

- Base URL: `https://develocity.example.com`
- URL: `https://develocity.example.com/api/projects`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/develocity/apis/develocity-api/docs/api/projects/get.ts> (a function with typed inputs; its response is checked against the schema)

**<mark>Beta:</mark>** Returns a paged list of projects configured for project-level access control.
If there are a lot of projects, then all pages will need to be retrieved in order to retrieve the full list of projects.
The default number of projects per page is 1,000.

## Query parameters

- `PageQuery` PageQuery
  - `pageNumber` integer: The index of the page to retrieve. The first page's index is zero.
  - `pageSize` integer: The maximum number of elements to include in the fetched page.

## Response `200`

A list of projects configured for project-level access control in Develocity.

- ProjectsPage: A paged list of projects configured for project-level access control in Develocity.
  - `content` Project[], required: A list of projects configured for project-level access control in Develocity.
    - `id` string, required: The unique identifier for the project. Must not contain whitespace.
    - `displayName` string: The label used when displaying the project.
    - `description` string: The description of the project group.
  - `page` PageMetadata, required: Information about the current and available page of elements. Pages are returned from list operations which could contain a lot of elements. One page contains a subset of the available elements. API users can retrieve all pages in order to retrieve all of the available elements.
    - `number` integer, required: The index of the current page. Page indexes start at zero.
    - `size` integer, required: The number of elements in the current page.
    - `totalPages` integer, required: The total number of pages.
    - `totalElements` integer, required: The total number of elements across all pages.

## Other responses

- `403`: The authenticated user has insufficient permissions.
- `404`: No API key was specified in the request, the key has been revoked, or the user bearing the key lacks permissions for this operation.

---

[API](https://skmtc.dev/develocity/apis/develocity-api.md) - [All operations](https://skmtc.dev/develocity/apis/develocity-api/llms.txt) - [OpenAPI document](https://skmtc.dev/develocity/apis/develocity-api/revisions/b49835fbf065?raw)