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

# Listing Projects

`GET /v1/projects`

The Projects listing endpoint is somewhat unique in that it is freely accessible to anybody, even unauthenticated clients. Rather than reject the user with a `403` or similar error, the Projects listing will only return Projects that the authenticated Actor is allowed to see. In most cases, this means that unauthenticated requests will receive `[]` in reply.

Currently, there are no paging or filtering options, so listing `Project`s will get you every Project you have access to.

This endpoint supports retrieving extended metadata; provide a header `X-Extended-Metadata: true` to additionally retrieve the `appUsers` count of App Users and `forms` count of Forms within the Project, as well as the `lastSubmission` timestamp of the latest submission to any for in the project, if any.

## Query parameters

- `forms` boolean
- `datasets` boolean

## Response `200`

OK

- Project[] — Standard Response
  - `id` number — The numerical ID of the Project.
  - `name` string, required — The name of the Project.
  - `description` string — The description of the Project, which is rendered as Markdown on Frontend.
  - `keyId` number — If managed encryption is enabled on the project, the numeric ID of the encryption key as tracked by Central is given here.
  - `archived` boolean — Whether the Project is archived or not. `null` is equivalent to `false`. All this does is sort the Project to the bottom of the list and disable management features in the web management application.

## Changes

- **2025-12-20** `022694254f0d` — 1 info
  - api operation id `Listing Projects` removed and replaced with `listProjects`
- **2025-03-13** `e8c2858fd4eb` — 1 info
  - api operation id `listProjects` removed and replaced with `Listing Projects`

[Change history](https://skmtc.dev/getodk/apis/odk-central-api/changes/v1/projects/get.md)

---

[API](https://skmtc.dev/getodk/apis/odk-central-api.md) · [All operations](https://skmtc.dev/getodk/apis/odk-central-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getodk/odk-central-api/revisions/d4f5ba77f644/schema)