Management report

The management report compiles your TokenID data into a polished PDF you can drop straight into a board pack, send to finance, or attach to a quarterly review. One API call, your logo on the cover, no spreadsheet wrangling.

What's in the report

Each report is divided into five sections. You can include or exclude any section at generation time.

Section	What it covers
Executive summary	Total spend, call volume, enforcement savings, and reconciliation status for the period
Spend breakdown	Cost by model, provider, session, and team — with period-over-period delta
Violations	Severity-ranked list of billing and usage anomalies, dollar impact highlighted
Enforcement	Rules that fired, spend blocked, and session count affected
Reconciliation	Matched vs. unmatched spend, confidence distribution, open disputes

Add your branding

Upload your logo and set your brand colour from Settings → Report Branding. These apply to all reports generated for your account.

Logo: PNG or SVG, square or wide — recommended minimum 300 × 100 px
Brand colour: used for section headings and the cover accent bar
Report footer: defaults to your organisation name and token.audit.id

If no branding is set, reports use the Vaudit default style.

Generate a report

1. Open [token.audit.id/app/reports](https://token.audit.id/app/reports). 2. Click **New report**. 3. Set the date range and toggle which sections to include. 4. Click **Generate** — the PDF downloads when ready (usually under 10 seconds).

```bash curl -X POST https://token.audit.id/api/v1/reports/management \ -H "Authorization: Bearer td_live_xxxx" \ -H "Content-Type: application/json" \ -d '{ "from": "2026-04-01", "to": "2026-04-30", "sections": ["summary", "spend", "violations", "enforcement", "reconciliation"] }' ``` The response is `application/pdf`. Pipe it to a file: ```bash curl -X POST https://token.audit.id/api/v1/reports/management \ -H "Authorization: Bearer td_live_xxxx" \ -H "Content-Type: application/json" \ -d '{"from":"2026-04-01","to":"2026-04-30"}' \ --output april-2026-ai-report.pdf ```

```python import httpx, pathlib client = httpx.Client( base_url="https://token.audit.id/api/v1", headers={"Authorization": "Bearer td_live_xxxx"}, ) resp = client.post("/reports/management", json={ "from": "2026-04-01", "to": "2026-04-30", }) resp.raise_for_status() pathlib.Path("april-2026-ai-report.pdf").write_bytes(resp.content) print("Report saved.") ```

Schedule recurring reports

Set a delivery schedule from Settings → Report Branding → Scheduled reports.

Cadence	Delivery
Weekly	Every Monday, covering the previous 7 days
Monthly	1st of each month, covering the previous calendar month
Quarterly	1st of January, April, July, October

Reports are emailed as PDF attachments to the recipients you specify. You can also receive them via webhook — see Alerts for webhook configuration.

Partial reports

To generate a report with only specific sections, pass the sections array:

curl -X POST https://token.audit.id/api/v1/reports/management \
  -H "Authorization: Bearer td_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{"from":"2026-04-01","to":"2026-04-30","sections":["summary","violations"]}'

Valid section values: summary, spend, violations, enforcement, reconciliation.

Report retention

Generated reports are stored for 90 days and available via GET /api/v1/reports. After 90 days they are deleted. Download and archive reports you need to keep longer.

Report generation uses your current branding settings at the time of generation. Updating your logo or brand colour does not retroactively change existing reports.