---
title: "Poll estimate status"
method: GET
path: "/api/v1/estimates/{estimate_id}"
tags: ["Estimates"]
---

# Poll estimate status

`GET /api/v1/estimates/{estimate_id}`

## Request

- Base URL: `https://fermi.kromatic.com` (the document declares no server; this is the origin it was published from)
- URL: `https://fermi.kromatic.com/api/v1/estimates/{estimate_id}`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Check the status of an async (tier 3) estimate. Returns the full result when completed.

## Path parameters

- `estimate_id` string, required

## Response `200`

Successful Response

- EstimatePollResponse: Union wrapper for GET /estimates/{id} polling. Fields are populated based on ``status``: - ``pending``: only ``estimate_id``, ``status``, ``retry_after_seconds`` - ``failed``: adds ``error_detail`` - ``completed``: all estimate fields populated
  - `estimate_id` string, required
  - `status` 'pending' | 'completed' | 'failed', required
  - `retry_after_seconds` integer, nullable
  - `request_id` string, nullable
  - `tier_id` integer, nullable
  - `created_at` string, date-time, nullable
  - `estimation_interval` EstimateInterval
    - `low` number, required
    - `high` number, required
  - `coverage_probability` number, nullable
  - `distribution_family` 'normal' | 'log_normal' | 'uniform' | 'constant' | 'beta' | 'triangle' | 'gamma' | 'exponential' | 'poisson', nullable
  - `distribution_parameters` object, nullable
  - `point_estimate` number, nullable
  - `range_low` number, nullable
  - `range_high` number, nullable
  - `confidence_level` 'low' | 'medium' | 'high', nullable
  - `reasoning_summary` string, nullable
  - `assumptions` string[], nullable
  - `credits_charged` integer, nullable
  - `disclaimer` string, nullable
  - `decomposition_suggestions` DecompositionSuggestion[], nullable
    - `sub_question` string, required
    - `reasoning` string, required
  - `research_sources` ResearchSource[], nullable
    - `url` string, nullable
    - `title` string, nullable
    - `snippet` string, nullable
    - `relevance_note` string, nullable
  - `verification_summary` string, nullable
  - `verification_flags` string[], nullable
  - `provider` 'openai' | 'anthropic', nullable
  - `model` string, nullable
  - `error_detail` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kromatic/apis/fermi.md) · [All operations](https://skmtc.dev/kromatic/apis/fermi/llms.txt) · [OpenAPI document](https://skmtc.dev/kromatic/apis/fermi/revisions/75a37f8067c2?raw)