# 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: 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:

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

The question should be specific, self-contained, and written in natural language.
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.