---
title: "Read tenant-bound Shadow Mode reports and aggregate outcomes"
method: GET
path: "/v1/protocol/shadow-reports"
---

# Read tenant-bound Shadow Mode reports and aggregate outcomes

`GET /v1/protocol/shadow-reports`

## Request

- Base URL: `https://api.decionis.com`
- URL: `https://api.decionis.com/v1/protocol/shadow-reports`
- Auth: HTTP bearer

## Query parameters

- `org_id` string, uuid, required
- `days` integer
- `limit` integer

## Response `200`

Shadow Mode report document containing rows and aggregate views

- ShadowReportDocument: Canonical Shadow Mode report document used for row and aggregate views.
  - `service` 'decionis', required
  - `generated_at` string, date-time, required
  - `org_id` string, uuid, required
  - `window_days` integer, required
  - `since` string, date-time, required
  - `summary` ShadowReportSummary, required
    - `shadow_evaluations` integer, required
    - `would_allow` integer, required
    - `would_block` integer, required
    - `would_escalate` integer, required
    - `review_required` integer, required
    - `non_allow_count` integer, required
    - `non_allow_rate` number, required
    - `policy_drift_count` integer, required
    - `policy_drift_rate` number, required
    - `near_miss_count` integer, required
    - `near_miss_rate` number, required
    - `candidate_enforcement_path_count` integer, required
  - `cards` ShadowReportCard[], required
    - `key` 'would_block' | 'would_escalate' | 'policy_drift' | 'near_misses' | 'candidate_enforcement_paths', required
    - `label` string, required
    - `value` integer, required
    - `rate` number, nullable, required
    - `severity` 'high' | 'medium' | 'low', required
  - `reason_breakdown` ShadowReportReason[], required
    - `reason_code` string, required
    - `count` integer, required
  - `candidate_enforcement_paths` ShadowReportPath[], required
    - `path_key` string, required
    - `workflow_key` string, nullable, required
    - `decision_type` string, required
    - `total` integer, required
    - `would_allow` integer, required
    - `would_block` integer, required
    - `would_escalate` integer, required
    - `review_required` integer, required
    - `near_miss_count` integer, required
    - `non_allow_rate` number, required
    - `near_miss_rate` number, required
    - `last_seen_at` string, date-time, required
    - `recommendation` 'CANDIDATE_FOR_ENFORCEMENT' | 'REVIEW_POLICY_BOUNDARY' | 'COLLECT_MORE_TRAFFIC', required
  - `near_misses` ShadowReportEvaluation[], required
    - `evaluation_id` string, uuid, required
    - `dossier_id` string, uuid, required
    - `decision_type` string, required
    - `workflow_key` string, nullable, required
    - `outcome` 'APPROVE' | 'ESCALATE' | 'REJECT' | 'REVIEW', required
    - `execution_action` 'CONTINUE' | 'STOP' | 'HAND_OFF' | 'REVIEW', required
    - `confidence` number, required
    - `risk_score` number, nullable, required
    - `policy_version` string, required
    - `reason_codes` string[], required
    - `created_at` string, date-time, required
    - `dossier_api_path` string, required
  - `recent_evaluations` ShadowReportEvaluation[], required
    - `evaluation_id` string, uuid, required
    - `dossier_id` string, uuid, required
    - `decision_type` string, required
    - `workflow_key` string, nullable, required
    - `outcome` 'APPROVE' | 'ESCALATE' | 'REJECT' | 'REVIEW', required
    - `execution_action` 'CONTINUE' | 'STOP' | 'HAND_OFF' | 'REVIEW', required
    - `confidence` number, required
    - `risk_score` number, nullable, required
    - `policy_version` string, required
    - `reason_codes` string[], required
    - `created_at` string, date-time, required
    - `dossier_api_path` string, required

## Other responses

- `401`: Bounded error response
- `403`: Bounded error response
- `429`: Bounded error response
- `500`: Bounded error response
- `503`: Bounded error response

---

[API](https://skmtc.dev/decionis/apis/decionis-commerce-gate-api.md) · [All operations](https://skmtc.dev/decionis/apis/decionis-commerce-gate-api/llms.txt) · [OpenAPI document](https://skmtc.dev/decionis/apis/decionis-commerce-gate-api/revisions/9fecb7109bf8?raw)