---
title: "Get Audit Summary"
method: GET
path: "/audits/summary"
tags: ["audits"]
---

# Get Audit Summary

`GET /audits/summary`

## Request

- Base URL: `https://api.verdun.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.verdun.ai/audits/summary`
- Auth: HTTP bearer

Lead dashboard: calls still needing an audit, disputes awaiting a ruling,
per-operator audit counts and the 50 most recent audits.

## Query parameters

- `days` integer: Look-back window in days, 1 to 90.

## Response `200`

Successful Response

- AuditSummaryResponse
  - `pending_review_count` integer: Peer overturns awaiting lead confirmation (all time, not windowed).
  - `sample_pct` integer, required: AUDIT_SAMPLE_PCT.
  - `needs_audit_count` integer, required: Calls in the window selected for audit (a human call that is sampled or rushed, or a sampled agent close) with no audit yet or a peer ruling that a lead may replace.
  - `pending_disputes` CallAuditListItem[], required: Disputes awaiting a ruling, oldest first.
    - `event_id` string, uuid, required: The audited alarm.
    - `evaluation_id` string, uuid, nullable: The audited evaluation; null once that evaluation or its deciding account is deleted.
    - `operator_id` string, uuid, nullable: The decider; null once that account is deleted, and always null when the decider is the AI agent.
    - `operator_name` string, required: Snapshot of the decider's name; "Verdun Agent" when the decider is the AI agent.
    - `decision` string, required: The decider's OperatorDisposition MEMBER NAME at audit time.
    - `verdict` 'upheld' | 'overturned', required: The lead's ruling on the original decision.
    - `correct_disposition` string, nullable: Overturned only: the disposition it should have been (member name).
    - `reason` string, nullable: Overturned only: the auditor's reason.
    - `auditor_id` string, uuid, nullable: The auditing lead; null once that account is deleted.
    - `auditor_name` string, required: Snapshot of the auditing lead's name.
    - `ad_hoc` boolean, required: True when the call was neither sampled nor rushed: a lead picked it themselves.
    - `created_at` string, date-time, required: When the audit was made.
    - `decider_is_agent` boolean: True when the audited decision was the AI agent's close (not a human operator's). Nobody loses points on such an audit and nobody can dispute it.
    - `points` integer, required: -1000 (SCORE_OVERTURN) charged to the decider while an overturn is active (confirmed, not reversed on dispute), else 0. Always 0 when the decider is the AI agent.
    - `catch_points` integer: Credited to a PEER auditor while their overturn is active, else 0 (a lead's overturn earns no catch): +1000 (SCORE_CATCH) for a human decider, +250 (SCORE_AGENT_CATCH) when the decider is the AI agent, 0 when `auto_confirmed`.
    - `auto_confirmed` boolean: A peer's overturn of an AI agent false alarm (Non-threatening -> False alarm): confirmed at once with no lead review (reviewed_by_id null) and worth 0 points. Only agent misses go to a lead and earn the agent catch.
    - `dispute` CallAuditDisputeOut
      - `note` string, required: The decider's dispute note.
      - `at` string, date-time, required: When the dispute was filed.
      - `status` 'pending' | 'reversed' | 'stands', required: pending until a different lead rules.
      - `ruled_by_id` string, uuid, nullable: The ruling lead; null while pending or once that account is deleted.
      - `ruled_by_name` string, nullable: Snapshot of the ruling lead's name.
      - `ruled_at` string, date-time, nullable: When the ruling was made.
    - `auditor_is_lead` boolean: Snapshot: the auditor was an owner or monitoring manager when they ruled (false = a peer operator).
    - `review_status` 'pending' | 'confirmed' | 'rejected', nullable: Overturned only (null on an upheld audit). A lead's overturn is confirmed at once; a peer's is pending until a lead confirms or rejects it. Only a confirmed overturn costs points.
    - `reviewed_by_id` string, uuid, nullable: The lead who confirmed or rejected the overturn (the auditor, for a lead's own); null while pending or once that account is deleted.
    - `reviewed_by_name` string, nullable: Snapshot of the reviewing lead's name.
    - `reviewed_at` string, date-time, nullable: When the overturn was confirmed or rejected.
    - `review_note` string, nullable: The reviewing lead's optional note.
    - `superseded_peer_audit` CallAuditRecord
      - `event_id` string, uuid, required: The audited alarm.
      - `evaluation_id` string, uuid, nullable: The audited evaluation; null once that evaluation or its deciding account is deleted.
      - `operator_id` string, uuid, nullable: The decider; null once that account is deleted, and always null when the decider is the AI agent.
      - `operator_name` string, required: Snapshot of the decider's name; "Verdun Agent" when the decider is the AI agent.
      - `decision` string, required: The decider's OperatorDisposition MEMBER NAME at audit time.
      - `verdict` 'upheld' | 'overturned', required: The lead's ruling on the original decision.
      - `correct_disposition` string, nullable: Overturned only: the disposition it should have been (member name).
      - `reason` string, nullable: Overturned only: the auditor's reason.
      - `auditor_id` string, uuid, nullable: The auditing lead; null once that account is deleted.
      - `auditor_name` string, required: Snapshot of the auditing lead's name.
      - `ad_hoc` boolean, required: True when the call was neither sampled nor rushed: a lead picked it themselves.
      - `created_at` string, date-time, required: When the audit was made.
      - `decider_is_agent` boolean: True when the audited decision was the AI agent's close (not a human operator's). Nobody loses points on such an audit and nobody can dispute it.
      - `points` integer, required: -1000 (SCORE_OVERTURN) charged to the decider while an overturn is active (confirmed, not reversed on dispute), else 0. Always 0 when the decider is the AI agent.
      - `catch_points` integer: Credited to a PEER auditor while their overturn is active, else 0 (a lead's overturn earns no catch): +1000 (SCORE_CATCH) for a human decider, +250 (SCORE_AGENT_CATCH) when the decider is the AI agent, 0 when `auto_confirmed`.
      - `auto_confirmed` boolean: A peer's overturn of an AI agent false alarm (Non-threatening -> False alarm): confirmed at once with no lead review (reviewed_by_id null) and worth 0 points. Only agent misses go to a lead and earn the agent catch.
      - `dispute` CallAuditDisputeOut
        - `note` string, required: The decider's dispute note.
        - `at` string, date-time, required: When the dispute was filed.
        - `status` 'pending' | 'reversed' | 'stands', required: pending until a different lead rules.
        - `ruled_by_id` string, uuid, nullable: The ruling lead; null while pending or once that account is deleted.
        - `ruled_by_name` string, nullable: Snapshot of the ruling lead's name.
        - `ruled_at` string, date-time, nullable: When the ruling was made.
      - `auditor_is_lead` boolean: Snapshot: the auditor was an owner or monitoring manager when they ruled (false = a peer operator).
      - `review_status` 'pending' | 'confirmed' | 'rejected', nullable: Overturned only (null on an upheld audit). A lead's overturn is confirmed at once; a peer's is pending until a lead confirms or rejects it. Only a confirmed overturn costs points.
      - `reviewed_by_id` string, uuid, nullable: The lead who confirmed or rejected the overturn (the auditor, for a lead's own); null while pending or once that account is deleted.
      - `reviewed_by_name` string, nullable: Snapshot of the reviewing lead's name.
      - `reviewed_at` string, date-time, nullable: When the overturn was confirmed or rejected.
      - `review_note` string, nullable: The reviewing lead's optional note.
    - `site_name` string, nullable: Site of the audited alarm.
    - `camera_name` string, nullable: Camera label of the audited alarm.
  - `by_operator` AuditOperatorSummary[], required: Audit counts by deciding operator for the requested window; the AI agent's audits form one "Verdun Agent" bucket with a null operator_id.
    - `operator_id` string, uuid, nullable: Deciding operator; null after account deletion.
    - `operator_name` string, required: Snapshot of the deciding operator's name.
    - `audited` integer, required: Audits of this operator's calls in the window.
    - `upheld` integer, required: Calls upheld in the window.
    - `overturned` integer, required: ACTIVE overturns only: confirmed, and not reversed on dispute.
    - `disputes_pending` integer, required: Window audits with a dispute awaiting a ruling.
  - `by_auditor` AuditAuditorSummary[]: Audit counts by the person who audited, for the requested window, most audits first.
    - `auditor_key` string, required: Stable grouping key surviving account deletion; legacy-unknown groups audits whose identity was already lost.
    - `auditor_id` string, uuid, nullable: The person who made the audits; null after account deletion.
    - `auditor_name` string, required: Snapshot of the auditor's name.
    - `audited` integer, required: Calls this person audited in the window (a lead's replacement of a peer audit counts for the lead).
    - `upheld` integer, required: Of those, calls they upheld.
    - `overturned` integer, required: Of those, ACTIVE overturns: confirmed, and not reversed on dispute.
    - `overturned_agent` integer: Of `overturned`, the AI agent's calls (auto-confirmed agent false alarms included).
    - `overturned_operator` integer: Of `overturned`, human operators' calls (`overturned` - `overturned_agent`).
    - `pending_review` integer, required: Of those, peer overturns still awaiting a lead's confirmation.
  - `recent` CallAuditListItem[], required: Up to 50 audits, newest ruling/dispute activity first.
    - `event_id` string, uuid, required: The audited alarm.
    - `evaluation_id` string, uuid, nullable: The audited evaluation; null once that evaluation or its deciding account is deleted.
    - `operator_id` string, uuid, nullable: The decider; null once that account is deleted, and always null when the decider is the AI agent.
    - `operator_name` string, required: Snapshot of the decider's name; "Verdun Agent" when the decider is the AI agent.
    - `decision` string, required: The decider's OperatorDisposition MEMBER NAME at audit time.
    - `verdict` 'upheld' | 'overturned', required: The lead's ruling on the original decision.
    - `correct_disposition` string, nullable: Overturned only: the disposition it should have been (member name).
    - `reason` string, nullable: Overturned only: the auditor's reason.
    - `auditor_id` string, uuid, nullable: The auditing lead; null once that account is deleted.
    - `auditor_name` string, required: Snapshot of the auditing lead's name.
    - `ad_hoc` boolean, required: True when the call was neither sampled nor rushed: a lead picked it themselves.
    - `created_at` string, date-time, required: When the audit was made.
    - `decider_is_agent` boolean: True when the audited decision was the AI agent's close (not a human operator's). Nobody loses points on such an audit and nobody can dispute it.
    - `points` integer, required: -1000 (SCORE_OVERTURN) charged to the decider while an overturn is active (confirmed, not reversed on dispute), else 0. Always 0 when the decider is the AI agent.
    - `catch_points` integer: Credited to a PEER auditor while their overturn is active, else 0 (a lead's overturn earns no catch): +1000 (SCORE_CATCH) for a human decider, +250 (SCORE_AGENT_CATCH) when the decider is the AI agent, 0 when `auto_confirmed`.
    - `auto_confirmed` boolean: A peer's overturn of an AI agent false alarm (Non-threatening -> False alarm): confirmed at once with no lead review (reviewed_by_id null) and worth 0 points. Only agent misses go to a lead and earn the agent catch.
    - `dispute` CallAuditDisputeOut
      - `note` string, required: The decider's dispute note.
      - `at` string, date-time, required: When the dispute was filed.
      - `status` 'pending' | 'reversed' | 'stands', required: pending until a different lead rules.
      - `ruled_by_id` string, uuid, nullable: The ruling lead; null while pending or once that account is deleted.
      - `ruled_by_name` string, nullable: Snapshot of the ruling lead's name.
      - `ruled_at` string, date-time, nullable: When the ruling was made.
    - `auditor_is_lead` boolean: Snapshot: the auditor was an owner or monitoring manager when they ruled (false = a peer operator).
    - `review_status` 'pending' | 'confirmed' | 'rejected', nullable: Overturned only (null on an upheld audit). A lead's overturn is confirmed at once; a peer's is pending until a lead confirms or rejects it. Only a confirmed overturn costs points.
    - `reviewed_by_id` string, uuid, nullable: The lead who confirmed or rejected the overturn (the auditor, for a lead's own); null while pending or once that account is deleted.
    - `reviewed_by_name` string, nullable: Snapshot of the reviewing lead's name.
    - `reviewed_at` string, date-time, nullable: When the overturn was confirmed or rejected.
    - `review_note` string, nullable: The reviewing lead's optional note.
    - `superseded_peer_audit` CallAuditRecord
      - `event_id` string, uuid, required: The audited alarm.
      - `evaluation_id` string, uuid, nullable: The audited evaluation; null once that evaluation or its deciding account is deleted.
      - `operator_id` string, uuid, nullable: The decider; null once that account is deleted, and always null when the decider is the AI agent.
      - `operator_name` string, required: Snapshot of the decider's name; "Verdun Agent" when the decider is the AI agent.
      - `decision` string, required: The decider's OperatorDisposition MEMBER NAME at audit time.
      - `verdict` 'upheld' | 'overturned', required: The lead's ruling on the original decision.
      - `correct_disposition` string, nullable: Overturned only: the disposition it should have been (member name).
      - `reason` string, nullable: Overturned only: the auditor's reason.
      - `auditor_id` string, uuid, nullable: The auditing lead; null once that account is deleted.
      - `auditor_name` string, required: Snapshot of the auditing lead's name.
      - `ad_hoc` boolean, required: True when the call was neither sampled nor rushed: a lead picked it themselves.
      - `created_at` string, date-time, required: When the audit was made.
      - `decider_is_agent` boolean: True when the audited decision was the AI agent's close (not a human operator's). Nobody loses points on such an audit and nobody can dispute it.
      - `points` integer, required: -1000 (SCORE_OVERTURN) charged to the decider while an overturn is active (confirmed, not reversed on dispute), else 0. Always 0 when the decider is the AI agent.
      - `catch_points` integer: Credited to a PEER auditor while their overturn is active, else 0 (a lead's overturn earns no catch): +1000 (SCORE_CATCH) for a human decider, +250 (SCORE_AGENT_CATCH) when the decider is the AI agent, 0 when `auto_confirmed`.
      - `auto_confirmed` boolean: A peer's overturn of an AI agent false alarm (Non-threatening -> False alarm): confirmed at once with no lead review (reviewed_by_id null) and worth 0 points. Only agent misses go to a lead and earn the agent catch.
      - `dispute` CallAuditDisputeOut
        - `note` string, required: The decider's dispute note.
        - `at` string, date-time, required: When the dispute was filed.
        - `status` 'pending' | 'reversed' | 'stands', required: pending until a different lead rules.
        - `ruled_by_id` string, uuid, nullable: The ruling lead; null while pending or once that account is deleted.
        - `ruled_by_name` string, nullable: Snapshot of the ruling lead's name.
        - `ruled_at` string, date-time, nullable: When the ruling was made.
      - `auditor_is_lead` boolean: Snapshot: the auditor was an owner or monitoring manager when they ruled (false = a peer operator).
      - `review_status` 'pending' | 'confirmed' | 'rejected', nullable: Overturned only (null on an upheld audit). A lead's overturn is confirmed at once; a peer's is pending until a lead confirms or rejects it. Only a confirmed overturn costs points.
      - `reviewed_by_id` string, uuid, nullable: The lead who confirmed or rejected the overturn (the auditor, for a lead's own); null while pending or once that account is deleted.
      - `reviewed_by_name` string, nullable: Snapshot of the reviewing lead's name.
      - `reviewed_at` string, date-time, nullable: When the overturn was confirmed or rejected.
      - `review_note` string, nullable: The reviewing lead's optional note.
    - `site_name` string, nullable: Site of the audited alarm.
    - `camera_name` string, nullable: Camera label of the audited alarm.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verdun/apis/verdun-api.md) - [All operations](https://skmtc.dev/verdun/apis/verdun-api/llms.txt) - [OpenAPI document](https://skmtc.dev/verdun/apis/verdun-api/revisions/35a2a6ebedda?raw)