---
title: "List estimate history"
method: GET
path: "/api/v1/estimates/history"
tags: ["Estimates"]
---

# List estimate history

`GET /api/v1/estimates/history`

## 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/history`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Returns your past estimates, newest first. Requires authentication.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- EstimateHistoryResponse
  - `estimates` EstimateHistoryItem[], required
    - `estimate_id` string, required
    - `request_id` string, required
    - `created_at` string, date-time, required
    - `question` string, required
    - `unit` string, required
    - `target_horizon` string, required
    - `context` string, nullable
    - `coverage_probability` number, required
    - `estimation_interval` EstimateInterval, required
      - `low` number, required
      - `high` number, required
    - `distribution_family` 'normal' | 'log_normal' | 'uniform' | 'constant' | 'beta' | 'triangle' | 'gamma' | 'exponential' | 'poisson', required
    - `distribution_parameters` object, required
    - `point_estimate` number, required
    - `reasoning_summary` string, nullable
    - `assumptions` string[], required
    - `source_inputs` EstimateSourceInput[]
      - `source_type` 'qualitative_text' | 'spreadsheet' | 'structured_file', required
      - `title` string, nullable
      - `content` string, nullable
      - `structured_data` union
        - object
        - object[]
      - `file_name` string, nullable
      - `media_type` string, nullable
      - `provenance` 'user' | 'agent' | 'file_upload'
    - `actual` EstimateActualRecord
      - `value` number, required
      - `unit` string, nullable
      - `recorded_at` string, date-time, required
      - `notes` string, nullable
      - `source_inputs` EstimateSourceInput[]
        - `source_type` 'qualitative_text' | 'spreadsheet' | 'structured_file', required
        - `title` string, nullable
        - `content` string, nullable
        - `structured_data` union
          - object
          - object[]
        - `file_name` string, nullable
        - `media_type` string, nullable
        - `provenance` 'user' | 'agent' | 'file_upload'
    - `model_id` string, nullable
    - `provider` string, nullable
    - `temperature` number, nullable
    - `reasoning_effort` 'minimal' | 'low' | 'medium' | 'high', nullable
    - `prompt_version` string, nullable
    - `as_of_timestamp` string, date-time, nullable
    - `run_fingerprint` 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)