---
title: "List report versions"
method: GET
path: "/report/{id}/versions"
tags: ["Report versions"]
---

# List report versions

`GET /report/{id}/versions`

## Request

- Base URL: `https://api.nullplatform.com`
- URL: `https://api.nullplatform.com/report/{id}/versions`
- Auth: HTTP bearer

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

## Path parameters

- `id` string, uuid, required

## Response `200`

The report's version history.

- ReportVersionListItem[]
  - `id` string, uuid: The unique identifier of this version.
  - `report_id` string, uuid: The ID of the report this version belongs to.
  - `version_number` integer: The sequential version number, starting at 1.
  - `name` string: The report's display name at the time this version was published.
  - `visibility` 'user' | 'organization': Who can see the report. `user` keeps it private to its owner; `organization` shares it with the whole organization.
  - `published_by` string: The ID of the user who published this version.
  - `created_at` string, date-time: The ISO 8601 timestamp of when this version was published.

## Other responses

- `4XX`: Client error responses due to invalid input or missing parameters.
- `5XX`: Internal server error due to an unexpected issue.

## Changes

- **2026-09-17** `43b3c1ecdfd8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nullplatform/apis/nullplatform-api/changes/report/:id/versions/get.md)

---

[API](https://skmtc.dev/nullplatform/apis/nullplatform-api.md) - [All operations](https://skmtc.dev/nullplatform/apis/nullplatform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nullplatform/apis/nullplatform-api/revisions/d3f66bc633d4?raw)