> 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 versions"
description: "List a dataset's published versions."
method: "GET"
endpoint: "/api/v1/projects/:projectId/datasets/:id/versions"
order: 4
group: "Versions"
last_verified: 2026-07-27
---

<ApiEndpoint method="GET" endpoint="/api/v1/projects/:projectId/datasets/:id/versions" description="List a dataset's published versions.">
  <section>
    #### Response
    ```json {{ title: 'Response' }}
    {
      "success": true,
      "message": "Versions retrieved successfully",
      "data": [
        {
          "id": "5e6f7a8b-...",
          "dataset_id": "1a2b3c4d-...",
          "version": 3,
          "description": "Add 40 new edge cases from Q3 support tickets",
          "item_count": 214,
          "checksum": "sha256:9f8e7d6c...",
          "storage_mode": "inline",
          "created_by": "3f2b1a0c-...",
          "created": 1753612800000
        }
      ]
    }
    ```
  </section>
</ApiEndpoint>