---
title: "Create Reason Preview"
method: POST
path: "/landing/reason-preview"
tags: ["landing"]
---

# Create Reason Preview

`POST /landing/reason-preview`

## 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/landing/reason-preview`
- Auth: none declared

Compare once, without retaining the visitor's reason.

## Request body

- LandingReasonPreviewRequest
  - `session_id` string, required
  - `ticker` string, required
  - `reason` string, required
  - `website` string
  - `turnstile_token` string, nullable

## Response `200`

Successful Response

- LandingReasonPreviewResult
  - `continuation_receipt` string, nullable
  - `artifact_id` string, required
  - `candidate_ref` VersionedRef, required
    - `entity_id` string, required
    - `version` integer, required
  - `ticker` string, required
  - `outcome` 'supports' | 'weakens' | 'uncertain', required
  - `explanation` string, required
  - `evidence` LandingReasonEvidence[], required
    - `evidence_id` string, required
    - `roles` string[], required
    - `title` string, required
    - `publisher` string, required
    - `source_url` string, required
    - `published_at` string, date-time, required
    - `excerpt` string, nullable
    - `display_policy` 'public_excerpt' | 'link_only' | 'attribution_only', required
  - `remains_unproven` string, required
  - `next_checkpoint` 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)