Bufdir Export Audit Service

Get export history for an organisation

{
  "data": [
    {
      "audit_id": "aud-20260301-001",
      "export_id": "exp-20260301-abc123",
      "org_id": "org-bufdir-042",
      "triggered_by_user_id": "usr-0042",
      "status": "completed",
      "format": "excel",
      "file_url": "https://storage.example.no/exports/exp-20260301-abc123.xlsx",
      "created_at": "2026-03-01T08:00:00Z",
      "updated_at": "2026-03-01T08:03:21Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 9
  }
}

Get a single audit record

{
  "audit_id": "aud-20260301-001",
  "export_id": "exp-20260301-abc123",
  "org_id": "org-bufdir-042",
  "triggered_by_user_id": "usr-0042",
  "status": "completed",
  "format": "excel",
  "period_from": "2025-01-01",
  "period_to": "2025-12-31",
  "file_url": "https://storage.example.no/exports/exp-20260301-abc123.xlsx",
  "activity_count": 312,
  "created_at": "2026-03-01T08:00:00Z",
  "updated_at": "2026-03-01T08:03:21Z"
}

Create a new audit entry when an export is initiated

{
  "export_id": "exp-20260326-xyz789",
  "org_id": "org-bufdir-042",
  "triggered_by_user_id": "usr-0099",
  "format": "pdf",
  "period_from": "2025-01-01",
  "period_to": "2025-12-31",
  "activity_types": [
    "group_session"
  ]
}

{
  "audit_id": "aud-20260326-007",
  "export_id": "exp-20260326-xyz789",
  "status": "queued",
  "created_at": "2026-03-26T10:00:00Z"
}

Update audit record status

{
  "status": "processing",
  "updated_at": "2026-03-26T10:00:10Z"
}

{
  "audit_id": "aud-20260326-007",
  "status": "processing",
  "updated_at": "2026-03-26T10:00:10Z"
}

Attach a generated file URL to an audit record

{
  "file_url": "https://storage.example.no/exports/exp-20260326-xyz789.pdf",
  "file_size_bytes": 1048576
}

{
  "audit_id": "aud-20260326-007",
  "file_url": "https://storage.example.no/exports/exp-20260326-xyz789.pdf",
  "updated_at": "2026-03-26T10:02:45Z"
}

Delete an audit record (admin only)

{
  "deleted": true,
  "audit_id": "aud-20260301-001"
}

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}