---
title: "List published reports"
method: GET
path: "/report/published"
tags: ["Report versions"]
---

# List published reports

`GET /report/published`

## Request

- Base URL: `https://api.nullplatform.com`
- URL: `https://api.nullplatform.com/report/published`
- Auth: HTTP bearer

Returns every report currently published and visible to you. Omits the heavy `schema`, `ui_schema`, and `queries` fields.

## Response `200`

The list of published reports.

- ReportListItem[]
  - `id` string, uuid: The unique report identifier.
  - `name` string: The report's display name.
  - `slug` string: A URL-friendly identifier for the report.
  - `description` string: A human-readable description of what the report shows.
  - `visibility` 'user' | 'organization': Who can see the report. `user` keeps it private to its owner; `organization` shares it with the whole organization.
  - `created_at` string, date-time: The ISO 8601 timestamp of when the report was created.
  - `updated_at` string, date-time: The ISO 8601 timestamp of the report's last update.

## 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/published/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)