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

# List Reports

`GET /reports`

## Request

- Base URL: `https://api.licenscheck.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.licenscheck.com/reports`
- Auth: none declared

List the proof reports this key issued, newest first.

Args:
    limit: Max reports to return.
    key: Injected: the caller's paid key.
    reports: Injected `ReportRepository`.

Returns:
    The reports.

## Query parameters

- `limit` integer: Max reports to return.

## Response `200`

Successful Response

- ReportListOut: Response for GET /reports.
  - `reports` ReportOut[], required: The key's reports, newest first.
    - `id` string, uuid, required: The report's ID, for GET /reports/{id}.pdf.
    - `code` string, required: Its verification code; anyone can check it at verify_url.
    - `license_id` string, uuid, required: The license it reports on.
    - `contractor_name` string, required: The licensee.
    - `state` string, required: The license's state.
    - `license_number` string, required: The license number.
    - `as_of` string, date-time, required: The moment it reports on.
    - `issued_at` string, date-time, required: When it was issued.
    - `level` 'clear' | 'review' | 'risk', required: The overall verification verdict for a license.
    - `sha256` string, required: The PDF's SHA-256: any changed copy won't match it.
    - `verify_url` string, required: The public page that confirms the report is genuine.

## Other responses

- `401`: No API key, or one that's wrong or revoked.
- `403`: A free key: proof reports need a paid plan.
- `422`: Validation Error

---

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