---
title: "Read anonymized policy benchmarks"
method: GET
path: "/api/decision/policies/{policy_id}/benchmarks"
tags: ["Benchmarks"]
---

# Read anonymized policy benchmarks

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

## Request

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

Returns decision_benchmark_v1 with caller metrics and opt-in anonymized cohort percentiles when minimum cohort privacy thresholds are met. Raw customer records are never exposed.

## Path parameters

- `policy_id` string, required

## Query parameters

- `policy_version` string
- `limit` integer
- `min_cohort_scopes` integer
- `min_cohort_decisions` integer

## Response `200`

Anonymized policy benchmark report

- DecisionBenchmark
  - `ok` boolean, required
  - `decision_benchmark_version` 'decision_benchmark_v1', required
  - `generated_at` string
  - `source` 'decision_outcomes'
  - `scope` 'caller_api_key_plus_anonymized_opt_in_cohort'
  - `policy_id` string, required
  - `policy_version` string, nullable
  - `privacy` object, required
    - `anonymized` boolean
    - `raw_records_exposed` false
    - `caller_excluded_from_cohort` boolean
    - `opt_in_required` boolean
    - `enabled` boolean
    - `minimum_cohort_scopes` integer
    - `minimum_cohort_decisions` integer
  - `your_metrics` object, required
  - `cross_customer` object, required
    - `status` 'available' | 'insufficient_cohort' | 'no_cohort_data' | 'disabled'
    - `cohort_scopes` integer
    - `cohort_decisions` integer
    - `threshold_met` boolean
    - `metrics` object, nullable
    - `percentiles` object, nullable
  - `comparison` object, nullable
  - `recommendation` 'benchmark_unavailable' | 'within_cohort_range' | 'review_policy_outcomes' | 'tighten_approval_policy' | 'reduce_manual_review_pressure', required
  - `benchmark_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)