---
title: "Read predictive policy confidence"
method: GET
path: "/api/decision/policies/{policy_id}/confidence"
tags: ["Confidence"]
---

# Read predictive policy confidence

`GET /api/decision/policies/{policy_id}/confidence`

## Request

- Base URL: `https://www.decide.fyi`
- URL: `https://www.decide.fyi/api/decision/policies/{policy_id}/confidence`
- Auth: API key in header `x-api-key`

Returns decision_confidence_v1 for a candidate verdict/action using latest Decision Outcome records within the caller API-key scope. Scores are deterministic confidence signals, not causal ML claims.

## Path parameters

- `policy_id` string, required

## Query parameters

- `policy_version` string
- `verdict` string
- `action` string
- `limit` integer
- `min_sample` integer

## Response `200`

Decision confidence baseline

- DecisionConfidence
  - `ok` boolean, required
  - `decision_confidence_version` 'decision_confidence_v1', required
  - `generated_at` string
  - `source` 'decision_outcomes'
  - `scope` 'caller_api_key'
  - `decision_id` string, nullable
  - `policy_id` string, nullable
  - `policy_version` string, nullable
  - `verdict` string
  - `action` string, nullable
  - `score` number, required
  - `level` 'high' | 'medium' | 'low' | 'weak' | 'insufficient_data', required
  - `based_on` integer
  - `similar_decisions` integer
  - `policy_stability` 'high' | 'medium' | 'low' | 'insufficient_data'
  - `recommendation` 'collect_more_outcomes' | 'high_confidence_proceed' | 'high_confidence_block' | 'high_confidence_review' | 'proceed_with_monitoring' | 'route_for_review' | 'monitor', required
  - `metrics` object
  - `baseline` object
  - `data_quality` object
  - `reasons` object[]
  - `confidence_hash` string, required

## Other responses

- `401`: API key missing, invalid, inactive, or unauthorized

---

[API](https://skmtc.dev/decide/apis/decide-decision-api.md) · [All operations](https://skmtc.dev/decide/apis/decide-decision-api/llms.txt) · [OpenAPI document](https://skmtc.dev/decide/apis/decide-decision-api/revisions/caf1d3069dfd?raw)