---
title: "List reports"
method: GET
path: "/report"
tags: ["Reports"]
---

# List reports

`GET /report`

## Request

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

Lists the reports visible to you. Omits the heavy `schema`, `ui_schema`, and `queries` fields.

## Query parameters

- `visibility` 'user' | 'organization': Who can see the report. `user` keeps it private to its owner; `organization` shares it with the whole organization.
- `limit` integer
- `offset` integer

## Response `200`

The list of reports matching the query.

- ReportList
  - `paging` object, required: Pagination details for the result set.
    - `limit` integer, required: The maximum number of results returned per page.
    - `offset` integer, required: The number of results skipped before this page.
  - `results` ReportListItem[], required: The reports in this page of results.
    - `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/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)