Export audit logs

Export verification and approval records for compliance reporting.

Prerequisites

• Admin access to your Aviator organization

• Completed verifications you want to export

Exporting from the dashboard

1. Navigate to audit logs

Go to Verify → Audit.

You’ll see a chronological list of all verification events: spec creations, approvals, verification runs, and results.

2. Filter the data

Use filters to narrow down what you need:

Filter	Options
Date range	Last 7 days, 30 days, 90 days, custom
Repository	All or specific repository
Event type	Spec created, Spec approved, Verification passed, Verification failed
Author	All or specific user

3. Export

Click Export and choose a format:

• JSON — Machine-readable, good for processing

• CSV — Spreadsheet-compatible

• PDF — Formatted report, good for auditors

The export includes all events matching your filters.

What’s included in exports

Each audit record contains:

Field	Description
timestamp	When the event occurred
event_type	Type of event (spec_created, spec_approved, verification_passed, etc.)
actor	Who performed the action
spec_id	The spec involved
spec_title	Human-readable spec title
repository	Repository name
pr_number	Associated pull request (if applicable)
commit_sha	Commit that was verified (if applicable)
verification_id	Unique ID for verification runs
result	Pass/fail details

Generating SOC 2 evidence

For SOC 2 audits, export:

1. Spec approvals — Shows segregation of duties (author ≠ approver)

2. Verification results — Shows systematic verification of all changes

3. Failure logs — Shows failures were addressed before merge

Filter by date range matching your audit period, export as PDF for easy sharing.

Scheduled exports

To schedule automatic exports:

1. Go to Verify → Settings → Scheduled Reports

2. Click Add Schedule

3. Configure:

   • Frequency (weekly, monthly)

   • Filters (repository, event types)

   • Format (JSON, CSV, PDF)

   • Delivery (email, webhook)

Reports are generated and delivered automatically.

API export

For programmatic access, use the Audit API:

curl -X GET "<https://api.aviator.co/v1/verify/audit>" \\
  -H "Authorization: Bearer$AVIATOR_API_KEY" \\
  -d "start_date=2024-01-01" \\
  -d "end_date=2024-01-31" \\
  -d "repository=your-org/your-repo"

See API Reference: Audit for full documentation.

Retention

Audit logs are retained indefinitely by default. Contact support if you need a specific retention policy.

See also

• Explanation: Audit trails and compliance

• Reference: Configuration options