> For the complete documentation index, see [llms.txt](/llms.txt).
> A full single-fetch corpus is available at [llms-full.txt](/llms-full.txt).
---
title: "List datasets"
description: "List a project's datasets."
method: "GET"
endpoint: "/api/v1/projects/:projectId/datasets"
order: 1
group: "Manage datasets"
last_verified: 2026-07-27
---

<ApiEndpoint method="GET" endpoint="/api/v1/projects/:projectId/datasets" description="List a project's datasets.">
  <section>
    #### Path parameters
    <ApiAttribute name="projectId" type="string" description="The project's UUID." required={true} />
  </section>
  <section>
    #### Response
    ```json {{ title: 'Response' }}
    {
      "success": true,
      "message": "Datasets retrieved successfully",
      "data": [
        {
          "id": "1a2b3c4d-...",
          "project_id": "b6f1a3e2-...",
          "name": "invoice-extraction-golden",
          "description": "Golden set of invoices with verified field extraction",
          "current_version_number": 3,
          "current_published_version_id": "5e6f7a8b-...",
          "draft_dirty": false,
          "storage_mode": "inline",
          "created_by": "3f2b1a0c-...",
          "created": 1732636800000,
          "updated": 1753612800000,
          "example_count": 214,
          "draft_item_count": 214
        }
      ]
    }
    ```
  </section>
</ApiEndpoint>