---
title: "List scan reports"
method: GET
path: "/scan/v3/reports"
tags: ["model-scanner_other"]
---

# List scan reports

`GET /scan/v3/reports`

Returns a cursor-paginated list of scan reports.

## Query parameters

- `page_size` integer
- `limit` integer
- `cursor` string
- `time` object
  - `lte` string, date-time
  - `gte` string, date-time

## Response `200`

Paginated scan reports

## Other responses

- `400` — The request failed due to a client error, with one or more of the following possible causes: 1. The request required a tenant_id field, which was missing. 2. The request was malformed syntactically or semantically.
- `422` — Validation Error

## Changes

> 44 revisions in range; 1 could not be searched.

- **2026-03-17** `26bbfabe7220` — 1 breaking, 3 info
  - added `#/components/schemas/ScanHighestDetectionSeverity, subschema #2: Scan Safety Verdict` to the `items/items/scan_result` response property `oneOf` list for the response status `200`
  - removed the `SAFE` enum value from the `items/items/scan_result` response property for the response status `200`
  - removed the `UNKNOWN` enum value from the `items/items/scan_result` response property for the response status `200`
  - removed the `UNSAFE` enum value from the `items/items/scan_result` response property for the response status `200`
- **2026-03-13** `cfd74ed5a336` — 1 breaking, 2 info
  - for the `query` request parameter `page_size`, default value `25` was removed
  - added the new optional `query` request parameter `limit`
  - `query` request parameter `page_size` was deprecated

[Change history](https://skmtc.dev/hiddenlayerai/apis/hiddenlayer-audit-api/changes/scan/v3/reports/get.md)

---

[API](https://skmtc.dev/hiddenlayerai/apis/hiddenlayer-audit-api.md) · [All operations](https://skmtc.dev/hiddenlayerai/apis/hiddenlayer-audit-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hiddenlayerai/hiddenlayer-audit-api/revisions/d8c55b669109/schema)