---
title: "Survivors Endpoint"
method: POST
path: "/v1/survivors"
---

# Survivors Endpoint

`POST /v1/survivors`

## Request

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

## Headers

- `Idempotency-Key` string, nullable

## Request body

- SurvivorsRequest: Same T x N matrix as PboRequest; the engine's own guards (row floor, bootstrap range, compute budget) answer as blocked reports, not 422s.
  - `returns_matrix` array[], required
    - number[]
  - `alpha` number
  - `n_bootstrap` integer
  - `block_length` integer, nullable
  - `periods_per_year` number

## Response `200`

Successful Response

- SurvivorsOutput
  - `_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
  - `method` 'romano_wolf_stepm_circular_block_bootstrap_studentized', required
  - `status` 'blocked' | 'computed', required
  - `verdict` 'conditional' | 'fail' | 'insufficient_evidence', required
  - `alpha` union, required
    - integer
    - number
  - `n_bootstrap` integer, required
  - `block_length` integer, nullable, required
  - `periods_per_year` union, required
    - integer
    - number
  - `reason` string, nullable, required
  - `per_config` SurvivorConfig[], nullable, required
    - `index` integer, required
    - `assessable` boolean, required
    - `mean_per_period` union, required
      - integer
      - number
    - `t_stat` union, required
      - integer
      - number
    - `survived_fwer` boolean, required
    - `rejected_in_round` integer, nullable, required
  - `survivors` SurvivorSet, required
    - `count` integer, required
    - `indices` integer[], required
  - `killed` KilledCount, required
    - `count` integer, required
  - `critical_values_by_round` union[], nullable, required
    - union
      - integer
      - number
  - `framing` string, required
  - `disclaimer` string, required
  - `died_at` string, nullable, required
  - `died_at_plain` string, nullable, required
  - `failure_codes` string[], required
  - `n_rows` integer, nullable
  - `n_configs` integer, 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)