---
title: "List Public Insight Candidates"
method: GET
path: "/internal/editorial/candidates"
tags: ["editorial feed"]
---

# List Public Insight Candidates

`GET /internal/editorial/candidates`

## 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/internal/editorial/candidates`
- Auth: API key in header `X-API-Key`

## Query parameters

- `cursor` string, nullable
- `limit` integer

## Response `200`

Successful Response

- PublicInsightFeedPage
  - `schema_version` 'public-insight-feed/v1'
  - `generated_at` string, date-time, required
  - `items` PublicInsightFeedItem[]
    - `cursor` string, required
    - `persisted_at` string, date-time, required
    - `payload_sha256` string, required
    - `candidate` PublicInsightCandidate, required
      - `schema_version` 'public-insight-candidate/v1'
      - `ref` VersionedRef, required
        - `entity_id` string, required
        - `version` integer, required
      - `event_refs` VersionedRef[], required
        - `entity_id` string, required
        - `version` integer, required
      - `canonical_insight_ref` VersionedRef, required
        - `entity_id` string, required
        - `version` integer, required
      - `security_id` integer, nullable
      - `ticker` string, nullable
      - `event_type` 'earnings' | 'guidance' | 'filing' | 'management_language' | 'price_move' | 'macro' | 'sector' | 'other', required
      - `event_title` string, required
      - `event_summary` string, required
      - `occurred_at` string, date-time, required
      - `observed_at` string, date-time, required
      - `as_of` string, date-time, required
      - `stale_after` string, date-time, required
      - `conclusion` string, required
      - `why_it_matters` string, required
      - `investment_case_implication` string, required
      - `uncertainty` string, required
      - `next_checkpoint` string, required
      - `confidence` 'low' | 'medium' | 'high', required
      - `insight_state` 'current' | 'corrected' | 'pending_correction' | 'superseded' | 'withdrawn', required
      - `public_thesis` PublicResearchThesis: A publisher-owned thesis built only from public research evidence.
        - `schema_version` 'public-research-thesis/v1'
        - `ref` VersionedRef, required
          - `entity_id` string, required
          - `version` integer, required
        - `security_id` integer, required
        - `ticker` string, required
        - `title` string, required
        - `statement` string, required
        - `factors` PublicThesisFactor[], required
          - `factor_id` string, required
          - `kind` 'claim' | 'expectation' | 'invalidation', required
          - `statement` string, required
          - `baseline_evidence_ids` string[], required
        - `baseline_evidence` EventEvidence[], required
          - `evidence_id` string, required
          - `source_type` 'filing' | 'earnings_call' | 'ir_presentation' | 'news' | 'market_data' | 'economic_release' | 'other', required
          - `provider_code` string, required
          - `publisher` string, required
          - `title` string, required
          - `source_url` string, required
          - `published_at` string, date-time, required
          - `observed_at` string, date-time, required
          - `source_artifact_version_id` integer, nullable
          - `source_segment_id` integer, nullable
          - `source_locator` string, nullable
          - `excerpt` string, nullable
          - `display_policy` 'public_excerpt' | 'link_only' | 'attribution_only' | 'internal_only' | 'unknown', required
          - `citation_valid` boolean, required
          - `is_primary` boolean, required
        - `as_of` string, date-time, required
        - `debate_key` string, nullable
        - `polarity` 'positive' | 'negative' | 'mixed', nullable
        - `status` 'draft' | 'active' | 'superseded' | 'retired'
        - `approved_at` string, date-time, nullable
        - `superseded_by` VersionedRef
          - `entity_id` string, required
          - `version` integer, required
        - `contains_private_user_data` boolean
      - `public_thesis_evaluation` PublicThesisEvaluation
        - `schema_version` 'public-thesis-evaluation/v1'
        - `ref` VersionedRef, required
          - `entity_id` string, required
          - `version` integer, required
        - `public_thesis_ref` VersionedRef, required
          - `entity_id` string, required
          - `version` integer, required
        - `canonical_insight_ref` VersionedRef, required
          - `entity_id` string, required
          - `version` integer, required
        - `event_refs` VersionedRef[], required
          - `entity_id` string, required
          - `version` integer, required
        - `thesis_title_snapshot` string, required
        - `thesis_statement_snapshot` string, required
        - `factor_evaluations` PublicThesisFactorEvaluation[], required
          - `factor_id` string, required
          - `factor_kind` 'claim' | 'expectation' | 'invalidation', required
          - `factor_statement_snapshot` string, required
          - `relationship` 'support' | 'contradict' | 'neutral', required
          - `materiality` 'material' | 'immaterial' | 'uncertain', required
          - `directness` 'direct' | 'indirect' | 'none', required
          - `citation_valid` boolean, required
          - `bridge_valid` boolean, required
          - `evidence_ids` string[], required
          - `reasoning` string, required
        - `overall_effect` 'strengthens' | 'weakens' | 'breaks' | 'mixed' | 'unrelated' | 'uncertain', required
        - `conclusion` string, required
        - `evaluated_at` string, date-time, required
        - `evaluation_version` string, required
        - `contains_private_user_data` boolean
      - `content_modes` ContentMode[], required
      - `evidence` PublicEvidence[], required
        - `evidence_id` string, required
        - `roles` EvidenceRole[], required
        - `source_type` 'filing' | 'earnings_call' | 'ir_presentation' | 'news' | 'market_data' | 'economic_release' | 'other', required
        - `provider_code` string, required
        - `publisher` string, required
        - `title` string, required
        - `source_url` string, required
        - `published_at` string, date-time, required
        - `observed_at` string, date-time, required
        - `source_artifact_version_id` integer, nullable
        - `source_segment_id` integer, nullable
        - `source_locator` string, nullable
        - `excerpt` string, nullable
        - `display_policy` 'public_excerpt' | 'link_only' | 'attribution_only' | 'internal_only' | 'unknown', required
      - `rank_components` RankComponents, required
        - `materiality` number, required
        - `novelty` number, required
        - `source_quality` number, required
        - `corroboration` number, required
        - `liquidity` number, required
        - `time_sensitivity` number, required
      - `global_significance_score` number, required
      - `selection_reason` string, required
      - `selection_policy_version` string, required
      - `tags` string[]
      - `requires_human_review` true
  - `next_cursor` string, nullable
  - `has_more` boolean, 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)