Docs

Reports & Exports

Generate compliance audit reports, cost breakdowns, and export trace data in multiple formats.

AITracer provides automated report generation and flexible data export so you can share trace data with auditors, stakeholders, and external systems.

Two report types and three export formats are available.

Report types

Audit Report

A comprehensive operational summary covering a configurable time period:

Total traces, executions, and alerts
Policy violations count
Total cost and token usage
Average latency across all executions
Models used and top actions
Compliance findings by category
Verification integrity rate (hash match percentage)

Cost Report

A detailed financial breakdown:

Total cost for the period
Cost by model (with token counts and execution volumes)
Cost by day (trend analysis)
Projected monthly spend
Top 10 most expensive traces

Generating a report

API

curl -X POST https://api.aitracer.app/api/reports \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "audit",
    "startDate": "2026-06-01T00:00:00Z",
    "endDate": "2026-07-01T00:00:00Z"
  }'

Set "type": "cost" for a cost report.

Audit report response

{
  "generatedAt": "2026-07-04T15:30:00Z",
  "period": { "start": "2026-06-01T00:00:00Z", "end": "2026-07-01T00:00:00Z" },
  "summary": {
    "totalTraces": 12500,
    "totalAlerts": 45,
    "totalCostUsd": 127.45,
    "totalTokens": 4500000,
    "averageLatencyMs": 340,
    "modelsUsed": ["gpt-4o", "claude-3-5-sonnet"]
  },
  "compliance": {
    "totalFindings": 12,
    "findingsByCategory": { "pii": 8, "regulated_health": 4 }
  },
  "verification": {
    "totalVerified": 12500,
    "hashMismatches": 0,
    "integrityRate": 1.0
  }
}

Cost report response

{
  "totalCostUsd": 127.45,
  "costByModel": [
    { "model": "gpt-4o", "costUsd": 89.32, "tokens": 2100000, "executions": 8500 }
  ],
  "costByDay": [
    { "date": "2026-06-15", "costUsd": 4.30, "tokens": 150000 }
  ],
  "projectedMonthlyCost": 120.50
}

Data export

Export your trace data or audit logs in three formats:

Format	Best for	Download as
CSV	Spreadsheets, Excel, Google Sheets	`.csv`
JSON	APIs, data pipelines, custom tooling	`.json`
JSON-LD	Linked data, semantic web, RDF systems	`.jsonld`

API

curl -X POST https://api.aitracer.app/api/export \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "csv",
    "type": "traces",
    "startDate": "2026-06-01T00:00:00Z",
    "endDate": "2026-07-01T00:00:00Z",
    "limit": 1000
  }'

The response is a downloadable file with appropriate content type headers:

Content-Type: text/csv
Content-Disposition: attachment; filename="aitracer-export-2026-07-04.csv"
X-Export-Count: 850

JSON-LD export

The JSON-LD format uses Schema.org vocabulary with @context and @type declarations, making it suitable for semantic data systems:

{
  "@context": "https://schema.org",
  "@type": "AIExecution",
  "@id": "aitracer:trace:tra_abc123",
  "actionName": "summarize-report",
  "model": "gpt-4o",
  "tokenCount": 1200,
  "costUsd": 0.0032
}

Combining reports with exports

A common workflow:

Generate a cost report to understand spending patterns
Export the specific traces that contributed to high costs
Evaluate those traces to determine if quality justifies cost
Archive the report and export for compliance records

Evaluations Terminology