---
title: "Listing Datasets"
method: GET
path: "/projects/{projectId}/datasets"
tags: ["Dataset Management"]
---

# Listing Datasets

`GET /projects/{projectId}/datasets`

The Dataset listing endpoint returns all published Datasets in a Project. If a Draft Form defines a new Dataset, that Dataset will not be included in this list until the Form is published.

## Path parameters

- `projectId` number, required

## Response `200`

OK

- Dataset[]
  - `name` string, required — The name of the Dataset
  - `createdAt` string, required — ISO date format.
  - `projectId` number, required — The numerical ID of the Project that the Dataset belongs to.
  - `approvalRequired` boolean — Control whether a Submission should be approved before an Entity is created from it.
  - `ownerOnly` boolean — If `ownerOnly` is `true`, and an Actor only has access to the Dataset CSV file via linked Form Attachments, then only Entities created by the Actor will be downloaded to the OpenRosa client. If `ownerOnly` is `false`, or if an Actor has direct access to the Dataset CSV file, then all Entities will be downloaded.

## Other responses

- `403` — Forbidden

## Changes

- **2025-06-09** `182b41228477` — 2 info
  - added the optional property `items/allOf[#/components/schemas/Dataset]/ownerOnly` to the response with the `200` status (media type: application/json; extended)
  - added the optional property `items/ownerOnly` to the response with the `200` status (media type: application/json)
- **2025-03-13** `e8c2858fd4eb` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/getodk/apis/odk-central-api/changes/projects/:projectId/datasets/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/fc2f2c8bd6a4/schema)