---
id: report-list-versions
title: "List report versions"
description: "Returns the published version history for a report, without the heavy `schema`, `ui_schema`, and `queries` fields."
sidebar_label: "List report versions"
hide_title: true
hide_table_of_contents: true
api: eJztV01z20YM/SuYvbSdoWxJkWObPblJ2jqTNm3sfEw9HgviguIm5C69C9pRNPrvHSypL8tNnBzaS3WQSGoBvH14ALFzxTgNKr1Qr6h2nuGGfDDOBnWZKE0h86Zm46xK1SvixtsAXBDUzaQ0oSC9XA+FCez8DHLnAcFHZwncGi5cw9GmILyZwThkBVU4TmDcmKvVDVoN4+uGvKEwhtxQqcOeSpSryaMAONUqVa3btDSBeyugiarRY0VMXjYyV0bQ1siFSpTFilSqjFaJ8nTdGE9apewbSlQbXKVzxbNaVgX2xk5VonLnK2SVqqYxWi3uMnFeEDTWXDcERpNlkxvy4PK4zRajYKePWNWlOM7zg+PD/iTvHRwPdW+ER7o3OTo46j0aHB5QNhqNDh4P1eIyUYGyxhuexX1MCD35k4YLlV5cyt+eQu1soCCgh/2+/OxCaxF8F+7mRjBlzjJZFkOs69Jkkdz990Gs57uUoPc4U4kyTFWMyobjllq5vGkjvDCBT5kqlSzt3OQ9ZazuMncCpZkWfEvyvcJHlv1sD15WhsODBCI7qb1og01LhtFfzuNXpNGsyNtO5ODoEU6Oj0e9w+Mh9kaDIfaOBzn2HvcPDoZ5PkA8zEUvbQquvhXV6dNtNW0hggmVzk4DsPsWlSWq83Nlm2pCfgOhsUxT8vdCCnTdCEdYrnC09gkERs/GTgEZBluQBotlBe6y8BndahPqEmcgpuJUiGBT0TYNtxjWfWibiadUl25WkWXIfQSezeLOTTATU8YCW0v5zfppsgOTbFNJe2xCJMb5KVrzKVbNbot8WzjI0EIg2uwFMBbrMXwgqgMYhtqbG2QCdiCSd7eW/I8w3nQ+hlCgp7hcumj0d1u4kmBz2fa+I8hFola0XE1mD+N+rTjxIYE2evxn6mH4aCQBM0/IpK+QPyt4jUw9yeT9GM5ewtHj/iDmOjBWtWC6Lcg+OPHD/vBxr3/YG/bPB8O030/7/b/Uov0kavTu3W7HfFIa0Ql57zysGizopk2PvcHSaDC2bhich8qEIFpfv3O+rq12mnsm4e5pl+t31IUKjNyEJ04LXdQZVBQCTkm0t90BN1Z/uaJ/PT//A1oLyJwmMFZH0HYaRRCjbVE76vclz9vu/0FQJ1BhVhhLPU+ocVJ2DttQXCBDhkxT580nageKHE3ZeNrO5gT1VSzfwCKyloIHRA9FHD6KpkJ7F4LYbkf5CTW8WkdZEvzlOFobucQSNDGaMgBOlsPOLoFdi4txooQrLKUwSENkxjIaS3qluE2BLQV8cJ+ATy2TFxSB/A35bp+dftFCY+ljTRmL7xAa+l+v/+v1X9FrBMeFk8l9ShwHdZll1X77XtyfG73Y35jjWwG3Q3zjS5WqgrkO6f4+1mbPNmVZl8gCYi9z1dbAfCaKbYW1OTavOBFHqhv5Y6riIpV0Fz8v31DP354rAW5s7nbHXQHZ4VWp6u8N9vo7NP+GFqcEemaxMlk3AoQUApV5b01b9xwmjSllSnEVIDw/e/k7xK2gHKSqBBBen3ZP2hn47M8XvQlmH0hDNw3vQQcOCrwhQNAec25lO3MNkDYcTU1VNRyltXN8C+3y0PgcM6kuOLVBZnRJZqJqF7jC2Bq6A5VM/MvhdCODW1TM123mvzk8drln+sj7dYnGyl6isOadFC+6SV0lKo2z+Obxt3CBZcl8PsFAr325WMhjCSQHtMtE3aA3QmhUrDZBrrVKcywDfYaM7191XfMHeOBR8t6dLI9oVubWGywbuVOJ+kCz9si7uFwkqiDUMuVfzLs/TrKMat4w2XkDSGGtKveXZ+cqUbhdTnfKJ3q/F8583q44dx/ILhYrdCz3AnCx+Bv6frmo
sidebar_class_name: "get api-method"
info_path: docs/api/reports
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"List report versions"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/report/{id}/versions"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Returns the published version history for a report, without the heavy `schema`, `ui_schema`, and `queries` fields.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uuid"},"description":"The unique identifier of the report.","example":"ff5970bf-592d-4a8d-b858-3175ec444562"}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The report's version history.","content":{"application/json":{"schema":{"type":"array","items":{"title":"ReportVersionListItem","type":"object","description":"A lightweight version entry. Omits `schema`, `ui_schema`, and `queries`.","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier of this version.","example":"183ab994-792a-412a-91fa-60552ff1aa7f"},"report_id":{"type":"string","format":"uuid","description":"The ID of the report this version belongs to.","example":"ff5970bf-592d-4a8d-b858-3175ec444562"},"version_number":{"type":"integer","description":"The sequential version number, starting at 1.","example":1},"name":{"type":"string","description":"The report's display name at the time this version was published.","example":"Deployment frequency"},"visibility":{"title":"Visibility","type":"string","enum":["user","organization"],"description":"Who can see the report. `user` keeps it private to its owner; `organization` shares it with the whole organization.","example":"user"},"published_by":{"type":"string","description":"The ID of the user who published this version.","example":"1234"},"created_at":{"type":"string","format":"date-time","description":"The ISO 8601 timestamp of when this version was published.","example":"2026-07-20T12:00:00Z"}}}}}}},"4XX":{"description":"Client error responses due to invalid input or missing parameters.","content":{"application/json":{"schema":{"title":"Error","type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code indicating the error.","example":400},"code":{"type":"string","description":"A machine-readable error code that categorizes the failure.","example":"bad_request"},"error":{"type":"string","description":"A short, human-readable error type.","example":"Bad Request"},"message":{"type":"string","description":"Additional details about the error.","example":"The request was malformed or contained invalid parameters."}}}}}},"5XX":{"description":"Internal server error due to an unexpected issue.","content":{"application/json":{"schema":{"title":"Error","type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code indicating the error.","example":400},"code":{"type":"string","description":"A machine-readable error code that categorizes the failure.","example":"bad_request"},"error":{"type":"string","description":"A short, human-readable error type.","example":"Bad Request"},"message":{"type":"string","description":"Additional details about the error.","example":"The request was malformed or contained invalid parameters."}}}}}}}}
>
  
</StatusCodes>