> For the complete documentation index, see [llms.txt](https://docs.kyvvu.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kyvvu.com/platform/reports.md).

# Reports

**What you'll learn:** How to generate compliance audit reports from the Kyvvu platform.

***

## Audit reports

The platform generates audit reports that summarize agent activity, policy compliance, and incident history. Reports are available in PDF and XML formats.

## Generating a report

### Via the dashboard

1. Open **Workspace → Reports**.
2. Select the report parameters:
   * **Format** — PDF or XML.
   * **Time range** — start and end dates.
   * **Agent** (optional) — restrict the report to a specific agent.
3. Click **Generate**.
4. Download the report when ready.

### Via the API

```bash
curl "https://platform.kyvvu.com/api/v1/reports/audit?format=pdf&start_date=2026-04-01&end_date=2026-04-30" \
  -H "Authorization: Bearer <JWT>" \
  -o audit-report.pdf
```

Query parameters:

| Parameter    | Type           | Required | Description                              |
| ------------ | -------------- | -------- | ---------------------------------------- |
| `format`     | `pdf` or `xml` | Yes      | Output format.                           |
| `start_date` | ISO date       | No       | Start of reporting period.               |
| `end_date`   | ISO date       | No       | End of reporting period.                 |
| `agent_id`   | string         | No       | Restrict the report to a specific agent. |

## Report contents

Reports include:

* **Agent summary** — registered agents, their classifications, and environments.
* **Policy summary** — active policies, their enforcement points and severities.
* **Incident summary** — violations grouped by severity, status, and agent.
* **Activity summary** — log volume, step type distribution, task counts.
* **Hash chain validation** — integrity status of the behavioral trace.

XML reports use a structured schema suitable for automated compliance tooling and regulatory submission.

***

## Next steps

* [Incident Management](/platform/incidents.md) — the incident data that feeds reports
* [Dashboard Guide](/platform/dashboard.md) — navigate the platform
* [Organizations & Access](/platform/organizations.md) — workspace isolation and access control for reports