---
title: "A question’s evidence, by proposition"
method: GET
path: "/workspaces/{id}/questions/{questionId}/evidence"
tags: ["evidence"]
---

# A question’s evidence, by proposition

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

## Request

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

## Path parameters

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

## Response `200`

The evidence.

- EvidenceList
  - `items` Evidence[], required
    - `id` string, uuid, required
    - `workspaceId` string, uuid, required
    - `questionId` string, uuid, required
    - `propositionId` string, uuid, required
    - `stance` 'supports' | 'contradicts' | 'qualifies', required
    - `summary` string, required
    - `source` string, required
    - `sourceUrl` string
    - `sourceKind` 'official-statistics' | 'law' | 'institution' | 'research' | 'modelling' | 'polling' | 'advocacy' | 'proposal' | 'expert-judgement' | 'management-estimate' | 'internal' | 'news' | 'first-person' | 'other', required
    - `sourceItemId` string, uuid: The question’s source document it was taken from.
    - `assertedBy` string
    - `assertedRole` 'decides' | 'knows' | 'affects' | 'affected' | 'challenges'
    - `declaredInterest` string: A stake whoever asserts it has in the outcome.
    - `publishedOn` string: When the source was published, YYYY-MM-DD.
    - `accessedOn` string: When it was read, YYYY-MM-DD.
    - `pinpoint` string: Where in the source: a page, table or section.
    - `quote` string: The passage it rests on, word for word, in the words of the version of its source that was read — found there before it was kept. A quote from an uploaded document is shown to its workspace only.
    - `quoteFound` boolean: Whether the quote was found in its source as read: false where it was looked for and is not there. Absent where nothing has looked yet.
    - `derivesFromId` string, uuid: The evidence it derives from. Evidence sharing a root is one family, not independent confirmation.
    - `lean` 'larger' | 'smaller' | 'either': For a qualification: which way it leans.
    - `whyThisSource` string: Why this source was chosen for this claim, in words: the authority on the fact, independent evidence, an interested party’s own claim, a person’s own experience, or a secondary source and why.
    - `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` EvidenceLinks, required: Relative /v1 URLs to follow.
      - `self` string, required
      - `decision` string, required
      - `proposition` string, required
      - `question` 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)