> ## Documentation Index
> Fetch the complete documentation index at: https://docs.isofold.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Reports

> Track your savings, query volume, and rewrite performance over time.

## Usage and Savings Reports

Isofold provides detailed reporting on how your queries are being optimized and how much you're saving.

You can access these reports in the [Isofold Dashboard](https://app.isofold.com) or export them programmatically via the API.

***

## Dashboard Views

In the UI, you'll find:

* **Query Volume** — total queries processed per day
* **Rewrite Coverage** — how many queries were successfully optimized
* **Savings Summary** — dollars saved and percent reduction
* **Diff Viewer** — before/after rewrite comparison

***

## Example: Savings Summary

```text theme={null}
Date         | Optimized | Avg Savings | Total Saved
-------------|-----------|-------------|-------------
2024-09-01   | 1,202     | $0.19       | $228.38
2024-09-02   | 975       | $0.22       | $214.50
2024-09-03   | 1,304     | $0.18       | $234.72
```

***

## Exporting Reports

You can export reports in JSON or CSV from the dashboard or via the REST API:

### CSV Export (Dashboard)

1. Visit your [Reports page](https://app.isofold.com/reports)
2. Select date range
3. Click **Export CSV**

### API Export (JSON)

```bash theme={null}
curl -H "Authorization: Bearer $ISOFOLD_API_KEY" \
  https://api.isofold.com/v1/reports/savings?start=2024-09-01&end=2024-09-30
```

Returns:

```json theme={null}
{
  "start": "2024-09-01",
  "end": "2024-09-30",
  "total_saved": 845.71,
  "queries_optimized": 4021,
  "average_savings": 0.21
}
```

***

## Alerts and Notifications

You can set up thresholds for daily or weekly alerts:

* “Notify me when daily savings exceed \$500”
* “Alert if optimization drops below 80%”

These can be configured via the dashboard or API.

***

For historical billing or usage questions, [contact support](mailto:support@isofold.com).