---
title: "Each option read from where the accepted ranges put it, filtered as the reader asks"
method: GET
path: "/workspaces/{id}/questions/{questionId}/explore"
tags: ["model"]
---

# Each option read from where the accepted ranges put it, filtered as the reader asks

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

## Request

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

## Path parameters

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

## Query parameters

- `horizon` 'all' | 'transition' | 'early' | 'medium' | 'long' | 'every': One horizon, with what names none; all (default) for every one.
- `scenario` union: One scenario's id, with what names none; all (default) for every one.
  - 'all'
  - string, uuid
- `show` 'all' | 'facts' | 'values': facts: empirical and mixed propositions; values: normative ones; all (default): every role.
- `verdicts` 'decided' | 'open' | 'all': decided (default): accepted propositions; open: every one not rejected; all: rejected too.
- `strength` 'any' | 'moderate' | 'strong': moderate: moderate or strong evidence; strong: strong alone; any (default).

## Response `200`

Every option’s standing.

- Explore: The model read with the view’s filters: each break-even once, with the ranges either side, and for each option what bears on it and is still open. No option is scored. All computed in SQL.
  - `shown` string[], required: The propositions the view keeps.
  - `breakEvens` object[], required: Every accepted break-even of a claim a person stood behind, once, with the accepted ranges below, across and above it.
    - `breakEvenId` string, uuid, required
    - `variableId` string, uuid, required
    - `threshold` number, required
    - `horizon` 'transition' | 'early' | 'medium' | 'long' | 'every' | 'null', nullable: The matched horizon: transition (Day One), early adjustment, medium term, long run, or every horizon. None: not stated — never every.
    - `consequence` string, required: What changes at the threshold.
    - `basis` 'derived' | 'published' | 'criterion' | 'asserted', required: How it is known: derived (its arithmetic shown), published, a published criterion, or asserted by a named party — which records that they say so, not that they are right.
    - `derivation` string, nullable: For a derived one: the arithmetic.
    - `source` string, nullable: Where it is published, or asserted.
    - `assertedBy` string, nullable: For an asserted one: who draws the line.
    - `belowOutcome` string, nullable: What occurs below the threshold.
    - `aboveOutcome` string, nullable: What occurs above it.
    - `compares` object[], required: The two options it compares, each perhaps one configuration, in no order; or none. Never which is ahead: which way a consequence counts is a judgement, not the model’s.
      - `optionId` string, uuid, required
      - `configurationId` string, uuid, nullable
    - `configurationId` string, uuid, nullable: For a break-even comparing no options: the configuration it holds under.
    - `scenarioId` string, uuid, nullable
    - `everyScenario` boolean
    - `measuredAgainst` string, nullable: What it is measured against: compared with a range’s baseline, never bridged.
    - `name` string, required
    - `unit` string, nullable, required
    - `propositionId` string, uuid, required
    - `below` string[], required
    - `above` string[], required
    - `across` string[], required
    - `withoutRange` object[]: The sides it compares with no accepted range read against them: nothing is filled in for them.
      - `optionId` string, uuid, required
      - `configurationId` string, uuid, nullable
  - `options` object[], required
    - `optionId` string, uuid, required
    - `breakEvenIds` string[], required: The break-evens that name it.
    - `figures` object, required
      - `propositions` integer, required
      - `openChallenges` integer, required
    - `valueChoices` string[], required
    - `undecided` string[], required
    - `untested` string[], required
    - `openChallengeIds` string[], required
    - `availability` object, required: Decided claims on whether it could be obtained, and on whether it would last — apart from its consequences.
      - `obtainable` string[], required
      - `durable` string[], required
    - `notYetConsidered` string[], required: Decided claims no person has considered against it yet: a common pressure among them reaches it provisionally.

## Other responses

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

---

[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)