---
title: "List Challenges"
method: GET
path: "/challenges"
tags: ["challenges"]
---

# List Challenges

`GET /challenges`

## Request

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

## Query parameters

- `limit` integer

## Response `200`

Successful Response

- ThesisChallengeRunOut[]
  - `id` integer, required
  - `subject` ThesisReadSubjectOut, required
    - `subject_type` 'company_thesis' | 'investment_theme', required
    - `subject_key` string, required
    - `label` string, required
    - `narrative` string, required
    - `version_number` integer, required
    - `updated_at` string, date-time, required
    - `is_active` boolean, required
    - `workspace_path` string, required
  - `status` 'pending' | 'running' | 'ready' | 'insufficient_evidence' | 'failed', required
  - `stage` 'queued' | 'evaluating' | 'complete' | 'failed', required
  - `evidence_window_days` 90, required
  - `candidate_count` integer, required
  - `result_limit` 3, required
  - `reserved_cost_usd` string, required
  - `settled_cost_usd` string, nullable, required
  - `pricing_source` string, required
  - `results` ThesisChallengeItemOut[], required
    - `affected_assumption` string, required
    - `counter_evidence` string, required
    - `why_it_matters` string, required
    - `confidence` 'high' | 'medium' | 'low', required
    - `evidence` ThesisChallengeEvidenceOut[], required
      - `record_key` string, required
      - `record_type` 'alert' | 'theme_finding', required
      - `title` string, required
      - `excerpt` string, required
      - `source` string, required
      - `source_url` string, required
      - `observed_at` string, date-time, required
      - `ticker` string, nullable
      - `relationship` string, nullable
      - `materiality` string, required
  - `error_code` string, nullable, required
  - `requested_at` string, date-time, required
  - `started_at` string, date-time, nullable, required
  - `finished_at` string, date-time, nullable, required
  - `thesis_changed` false
  - `relationships_changed` false
  - `recovery_path` string, required

## Other responses

- `422`: Validation Error

---

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