---
title: "Conformal Endpoint"
method: POST
path: "/v1/conformal"
---

# Conformal Endpoint

`POST /v1/conformal`

## Request

- Base URL: `https://api.alphaassay.com`
- URL: `https://api.alphaassay.com/v1/conformal`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string, nullable

## Request body

- ConformalRequest: Prediction intervals (lower/upper), realised outcomes and the claimed coverage level. The engine's own guards (length match, inverted bounds, calibration constructibility, power floor) answer as blocked reports.
  - `intervals_lower` number[], required
  - `intervals_upper` number[], required
  - `outcomes` number[], required
  - `claimed_coverage` number
  - `calibration_size` integer, nullable

## Response `200`

Successful Response

- ConformalOutput
  - `_meta` PublicMeta, required
    - `engine_version` string, required
    - `api_version` string, required
    - `as_of` string, date-time, required
    - `input_digest` string, required
    - `request_digest` string, required
    - `tenant_scope` string, required
    - `tenant_scope_version` string, required
    - `request_id` string, nullable, required
    - `source_identity_digest` string, required
    - `operation` string, required
    - `statefulness` 'pure' | 'public_read' | 'tenant_read' | 'tenant_write', required
    - `not_financial_advice` true, required
    - `disclaimer` string, required
  - `schema` 'conformal.v1', required
  - `method` 'split_conformal_coverage_audit', required
  - `status` 'blocked' | 'computed', required
  - `verdict` 'pass' | 'fail' | 'insufficient_evidence', required
  - `n` integer, nullable, required
  - `claimed_coverage` union, required
    - integer
    - number
  - `died_at` string, nullable, required
  - `died_at_plain` string, nullable, required
  - `failure_codes` string[], required
  - `advisories` string[], required
  - `reason` string, nullable
  - `hits` integer, nullable
  - `misses` integer, nullable
  - `empirical_coverage` union
    - integer
    - number
  - `distribution` 'binomial' | 'beta_binomial', nullable
  - `calibration_size` integer, nullable
  - `k_order_statistic` integer, nullable
  - `zone` TrafficLightZone
    - `zone` 'green' | 'yellow' | 'red', required
    - `cumulative_prob` union, required
      - integer
      - number
    - `zone_thresholds` ZoneThresholds, required
      - `yellow_at_cumulative_prob` union, required
        - integer
        - number
      - `red_at_cumulative_prob` union, required
        - integer
        - number
  - `efficiency` ConformalEfficiency
    - `mean_width` union, required
      - integer
      - number
    - `median_width` union, required
      - integer
      - number
    - `degenerate_share` union, required
      - integer
      - number
    - `outcome_range` union, required
      - integer
      - number
    - `width_to_range_ratio` union, required
      - integer
      - number
    - `uninformative_at_ratio` union, required
      - integer
      - number
  - `halves` ConformalHalves
    - `coverage_first_half` union, required
      - integer
      - number
    - `coverage_second_half` union, required
      - integer
      - number
  - `interpretation` string, nullable

## Other responses

- `401`: Request could not be completed
- `402`: Request could not be completed
- `403`: Request could not be completed
- `409`: Request could not be completed
- `413`: Request could not be completed
- `422`: Request could not be completed
- `429`: Request rate limit exceeded
- `500`: Internal execution failure
- `503`: Request could not be completed

---

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