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

# List Reports

`GET /v1/reports`

## Request

- Base URL: `https://api.mindfort.app`
- URL: `https://api.mindfort.app/v1/reports`
- Auth: HTTP bearer

Lists generated reports for your organization, including each report's target, status, and options, with limit and offset pagination.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Successful response

- PublicReportList
  - `reports` PublicReport[], required
    - `id` string, uuid, required
    - `target_id` string, uuid, required
    - `target_name` string, required
    - `status` string, required
    - `created_at` string, date-time, required
    - `include_secured_findings` boolean, required
    - `include_resolved_findings` boolean, required
    - `report_detail_level` 'full' | 'condensed', required
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key
- `403`: Not permitted for this organization
- `404`: Resource not found

---

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