---
id: report-list
title: "List reports"
description: "Lists the reports visible to you. Omits the heavy `schema`, `ui_schema`, and `queries` fields."
sidebar_label: "List reports"
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={"List reports"}
>
</Heading>

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



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

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

<ParamsDetails
  parameters={[{"in":"query","name":"visibility","schema":{"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"},"description":"Filter by visibility.","example":"user"},{"in":"query","name":"limit","schema":{"type":"integer"},"description":"The maximum number of results to return per page.","example":20},{"in":"query","name":"offset","schema":{"type":"integer","minimum":0,"default":0},"description":"The starting point for pagination.","example":0}]}
>
  
</ParamsDetails>

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

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The list of reports matching the query.","content":{"application/json":{"schema":{"title":"ReportList","type":"object","required":["paging","results"],"properties":{"paging":{"type":"object","description":"Pagination details for the result set.","required":["limit","offset"],"properties":{"limit":{"type":"integer","minimum":1,"description":"The maximum number of results returned per page.","example":20},"offset":{"type":"integer","minimum":0,"description":"The number of results skipped before this page.","example":0}}},"results":{"type":"array","description":"The reports in this page of results.","items":{"title":"ReportListItem","type":"object","description":"A lightweight report entry. Omits `schema`, `ui_schema`, and `queries`.","properties":{"id":{"type":"string","format":"uuid","description":"The unique report identifier.","example":"ff5970bf-592d-4a8d-b858-3175ec444562"},"name":{"type":"string","description":"The report's display name.","example":"Deployment frequency"},"slug":{"type":"string","description":"A URL-friendly identifier for the report.","example":"deployment-frequency"},"description":{"type":"string","description":"A human-readable description of what the report shows.","example":"How often each application deploys"},"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"},"created_at":{"type":"string","format":"date-time","description":"The ISO 8601 timestamp of when the report was created.","example":"2026-07-20T12:00:00Z"},"updated_at":{"type":"string","format":"date-time","description":"The ISO 8601 timestamp of the report'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>