---
title: "Every party’s range for every variable in a question"
method: GET
path: "/workspaces/{id}/questions/{questionId}/estimates"
tags: ["switching"]
---

# Every party’s range for every variable in a question

`GET /workspaces/{id}/questions/{questionId}/estimates`

## Request

- Base URL: `https://api.swingfactor.ai/v1`
- URL: `https://api.swingfactor.ai/v1/workspaces/{id}/questions/{questionId}/estimates`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required
- `questionId` string, uuid, required

## Response `200`

The ranges, kept apart.

- EstimateList
  - `items` Estimate[], required
    - `id` string, uuid, required
    - `workspaceId` string, uuid, required
    - `questionId` string, uuid, required
    - `variableId` string, uuid, required
    - `low` number, required
    - `high` number, required
    - `source` string, required
    - `assertedBy` string
    - `assertedRole` 'decides' | 'knows' | 'affects' | 'affected' | 'challenges'
    - `horizon` 'transition' | 'early' | 'medium' | 'long' | 'every': The matched horizon: transition (Day One), early adjustment, medium term, long run, or every horizon. None: not stated — never every.
    - `scenarioId` string, uuid
    - `everyScenario` boolean: It holds whichever scenario happens. Never with a scenario. Neither: not stated.
    - `configurationId` string, uuid: The configuration it holds under: the same quantity under another package is another range.
    - `everyConfiguration` boolean: It holds under every configuration of the options its claim bears on. Neither: not stated.
    - `basis` 'published' | 'derived' | 'judgement': Published by its source, derived by the project (with its arithmetic), or a judgement.
    - `derivation` string: For a derived range: its arithmetic.
    - `measuredAgainst` string: The baseline it is measured against.
    - `status` 'proposed' | 'accepted' | 'rejected', required: Changes only by a person’s decision.
    - `decidedBy` string, uuid
    - `decidedByName` string
    - `decidedAt` string
    - `createdBy` string, uuid
    - `createdAt` string, required
    - `draftId` string, uuid: Set where SwingFactor drafted it.
    - `updatedAt` string, required
    - `links` EstimateLinks, required: Relative /v1 URLs to follow.
      - `self` string, required
      - `decision` string, required
      - `variable` string, required
  - `total` integer, required
  - `offset` integer, required
  - `limit` integer, required

## Other responses

- `401`: No token, or not a valid one: `unauthorized`.

---

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