---
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.

---

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