---
id: report-get-published-version
title: "Get the published version"
description: "Returns the report's currently published version, with all fields."
sidebar_label: "Get the published version"
hide_title: true
hide_table_of_contents: true
api: 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
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={"Get the published version"}
>
</Heading>

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



Returns the report's currently published version, with all 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 currently published version.","content":{"application/json":{"schema":{"title":"ReportVersion","type":"object","description":"An immutable snapshot of a report's draft, taken when the report was published.","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"},"slug":{"type":"string","description":"The report's slug at the time this version was published.","example":"deployment-frequency"},"description":{"type":"string","description":"The report's description at the time this version was published.","example":"How often each application deploys"},"schema":{"type":"object","additionalProperties":true,"description":"The JSON Schema snapshot included in this version."},"ui_schema":{"type":"object","additionalProperties":true,"description":"The UI Schema snapshot included in this version."},"queries":{"title":"Queries","type":"object","description":"A map of query IDs to query definitions. Each ID is a name you choose to identify the query within the report.","additionalProperties":{"title":"QueryDefinition","type":"object","required":["source"],"additionalProperties":false,"properties":{"source":{"type":"string","description":"The SQL `SELECT` statement the query runs. It can include `{name:Type}` placeholders that take their values from form fields, as declared in `params`.","example":"SELECT name FROM environments WHERE account = {account:String}"},"params":{"type":"object","description":"Binds the placeholders in `source` to form fields. Each key matches a placeholder name in the query.","additionalProperties":{"type":"object","required":["scope"],"additionalProperties":false,"properties":{"scope":{"type":"string","description":"A JSON Pointer to the form field that supplies the placeholder's value.","example":"#/properties/account"}}}},"target":{"type":"string","description":"A JSON Pointer to the schema property this query populates with its results.","example":"#/properties/environment"},"mapping":{"type":"string","enum":["enum"],"description":"How query results map onto the `target` field. Use `enum` to turn the results into the field's selectable options.","example":"enum"}}}},"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"},"updated_at":{"type":"string","format":"date-time","description":"The ISO 8601 timestamp of this version's last update.","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>