> 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. Navigate to **Reports** in the sidebar.
2. Select the report parameters:
   * **Format** — PDF or XML.
   * **Time range** — start and end dates.
   * **Agent** (optional) — scope 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       | Scope to a specific agent. |

## Report contents

Reports include:

* **Agent summary** — registered agents, their classifications, and environments.
* **Policy summary** — active policies, their scopes 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) — access control for reports


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.kyvvu.com/platform/reports.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.