---
title: "Get confidence calibration status"
method: GET
path: "/v1/calibration"
tags: ["Calibration"]
---

# Get confidence calibration status

`GET /v1/calibration`

## Request

- Base URL: `https://api.algenta.ai`
- URL: `https://api.algenta.ai/v1/calibration`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Returns the org's historical prediction accuracy metrics computed from all recorded outcomes (`PATCH /v1/decisions/{id}/outcome`). The `confidence_multiplier` is applied automatically to every simulation and recommendation once `n_samples >= 5`.

**Key fields**
- `bias`: mean relative error — negative means over-optimistic
- `hit_rate`: fraction of predictions within ±20% of actual
- `confidence_multiplier`: factor currently applied to raw simulation confidence
- `is_reliable`: false until 5+ outcomes are recorded

## Response `200`

Successful Response

- CalibrationResponse: Org-level confidence calibration state.
  - `org_id` string, required
  - `is_reliable` boolean, required
  - `n_samples` integer, required
  - `bias` number, nullable, required
  - `rmse_pct` number, nullable, required
  - `hit_rate` number, nullable, required
  - `direction` string, required
  - `confidence_multiplier` number, required
  - `summary` string, required
  - `last_updated` string, nullable, required

---

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