# Beliefs

Find investor beliefs or inspect a full record

> Section: API reference

> Last updated: **2026-10-24**.

> API version: **v1 (Latest)**. OpenAPI publication: **2026-11-08**.

## `GET /v1/beliefs`

Search investment theses; inspect evidence, revisions, and available outcomes. Search across released research with view=search and q, filter a company by person or changed_since, or use belief_id for the complete record. Optional scenarios test assumed condition statuses; they do not predict analyst behavior. Do not combine belief_id with collection filters.

Lifecycle: **stable**. Availability: **released**. Account-based authentication: **Bearer API key**.

Accountless alternative: the [x402 catalog](/v1/research) exposes POST /v1/research/{tool} and native MCP at /v1/research/mcp. Fourteen data tools cost 0.02 USDC per call on Base; built-in comparison costs 0.50 USDC and search costs 1.50 USDC. GET /v1/brief/{ticker} still supports the 0.02-USDC overview. Check free /v1/tickers coverage first, then follow the [x402 quickstart](/agent-quickstart.md#pay-per-call-with-x402). Bearer examples below apply to account-based access.

## Examples

Requires a Bearer API key. Replace `<api-key>` in each request with your developer key. Uses an included request or $0.02 in enabled prepaid credit for a successful new billable read.

Response excerpts below illustrate the shape only; placeholders and empty arrays are not live research or proof of coverage. Actual responses include additional fields.

### Search investment theses

Find released investment cases by thesis, topic, catalyst, or risk without choosing a ticker first. Results include ranked belief IDs, cited passages, and coverage information.

```bash
curl --request GET \
  --url 'https://beliefstate.ai/v1/beliefs?view=search&q=pricing+power&limit=10' \
  --header 'Authorization: Bearer <api-key>'
```

Response excerpt:

```json
{
  "view": "search",
  "data": {
    "matches": [
      {
        "belief_id": "<belief-id>",
        "summary": "<matched thesis>"
      }
    ]
  }
}
```

Read a returned belief_id for complete context. Incomplete search coverage or ranking returns data_unavailable without matches or a charge. Search cursors expire after 15 minutes.

### Browse a company's beliefs

List released beliefs for a company, including the attributed analyst, thesis, direction, status, and observation times.

```bash
curl --request GET \
  --url 'https://beliefstate.ai/v1/beliefs?ticker=NVDA&limit=10' \
  --header 'Authorization: Bearer <api-key>'
```

Response excerpt:

```json
{
  "data": {
    "beliefs": [
      {
        "belief_id": "<belief-id>",
        "person": {
          "id": "<person-id>"
        }
      }
    ]
  }
}
```

Choose a covered ticker from /v1/tickers. Follow pagination.next_cursor for more records; the cursor preserves the filters and observation cutoff.

### Read an analyst's recorded views

Filter a company's beliefs to one attributed investor. This returns their recorded views within the available research coverage.

```bash
curl --request GET \
  --url 'https://beliefstate.ai/v1/beliefs?ticker=NVDA&person_id=person-id-from-response&limit=10' \
  --header 'Authorization: Bearer <api-key>'
```

Response excerpt:

```json
{
  "data": {
    "beliefs": [
      {
        "belief_id": "<belief-id>",
        "person": {
          "id": "<person-id>"
        }
      }
    ]
  }
}
```

Replace person-id-from-response with person.id from a belief list or person_id from a search result. This is a research history, not a complete portfolio or verified trade record.

### Inspect evidence, revisions, and outcomes

Open one full belief record with its claims, supporting citations, revision history, conditions, and available measured outcomes.

```bash
curl --request GET \
  --url 'https://beliefstate.ai/v1/beliefs?belief_id=belief-id-from-response' \
  --header 'Authorization: Bearer <api-key>'
```

Response excerpt:

```json
{
  "data": {
    "belief": {
      "belief_id": "<belief-id>",
      "revisions": [],
      "outcomes": []
    }
  }
}
```

Replace belief-id-from-response with a returned belief_id. Do not combine it with ticker, person_id, or other list filters. Empty revision or outcome arrays mean no released records of that kind are available.

### Find changed beliefs

Find beliefs with initial research, author revisions, condition updates, or released outcomes becoming available after a chosen time.

```bash
curl --request GET \
  --url 'https://beliefstate.ai/v1/beliefs?ticker=NVDA&changed_since=2026-10-01T00%3A00%3A00Z&limit=10' \
  --header 'Authorization: Bearer <api-key>'
```

Response excerpt:

```json
{
  "data": {
    "beliefs": []
  }
}
```

Set changed_since to your RFC 3339 cutoff and follow pagination. An empty list means no matching available records. This filter is not the separately gated ordered change feed and does not provide an event-history checkpoint.

## Request

```bash
curl --request GET \
  --url 'https://beliefstate.ai/v1/beliefs?limit=10' \
  --header 'Authorization: Bearer <api-key>'
```

```javascript
const options = { method: "GET", headers: {"Authorization":"Bearer <api-key>"} };

fetch("https://beliefstate.ai/v1/beliefs?limit=10", options)
  .then((response) => response.json())
  .then((data) => console.log(data));
```

```python
import requests

url = "https://beliefstate.ai/v1/beliefs?limit=10"
headers = {"Authorization":"Bearer <api-key>"}

response = requests.get(url, headers=headers)
print(response.text)
```

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `X-Request-ID` | header | `string` | no | Stable ID for an idempotent retry. Reuse it only for the same logical request. |
| `ticker` | query | `string` | no | Ticker for a list. Use belief_id instead for one full record, or cursor for the next page. |
| `refresh_market_data` | query | `boolean` | no | Filter by refresh_market_data. |
| `as_of` | query | `string<date-time>` | no | RFC 3339 point in time cutoff. Future values are clamped. |
| `limit` | query | `integer` | no | Maximum belief records to return, from 1 to 50. |
| `cursor` | query | `string` | no | Opaque continuation token returned by the previous page. It preserves the original filters and as_of snapshot. |
| `person_id` | query | `string` | no | Filter by canonical person identifier. |
| `direction` | query | `enum` | no | Filter by released belief direction. |
| `status` | query | `enum` | no | Filter by released belief lifecycle state. |
| `time_horizon` | query | `string` | no | Filter by time_horizon. |
| `changed_since` | query | `string<date-time>` | no | Return beliefs changed after this RFC 3339 time. |
| `entity_id` | query | `string<uuid>` | no | Filter by entity_id. |
| `view` | query | `enum` | no | compare with belief_id and compare_to_belief_id for two complete cited cases, search for corpus investment content, entities for subject discovery, or changes for the enabled ordered feed. Omit for ticker/entity inventory or belief detail. |
| `compare_to_belief_id` | query | `string<uuid>` | no | Second distinct released belief UUID for view=compare; first case uses belief_id. Both complete cases require at most eight paragraphs each and 20,000 characters combined. Historical as_of only replays assessments already recorded by that cutoff. Unavailable comparisons are uncharged. |
| `source_id` | query | `string<uuid>` | no | Filter by source_id. |
| `domain` | query | `enum` | no | Filter by domain. |
| `event_kind` | query | `string` | no | Filter by event_kind. |
| `revision_only` | query | `boolean` | no | Filter by revision_only. |
| `object_status` | query | `string` | no | Filter by object_status. |
| `severity` | query | `enum` | no | Filter by severity. |
| `published_from` | query | `string<date-time>` | no | Filter by published_from. |
| `published_through` | query | `string<date-time>` | no | Filter by published_through. |
| `comparison_focus` | query | `string` | no | Filter by comparison_focus. |
| `checkpoint` | query | `string` | no | Filter by checkpoint. |
| `corpus` | query | `"released"` | no | Filter by corpus. |
| `resync` | query | `boolean` | no | Filter by resync. |
| `q` | query | `string` | no | With view=search, a thesis/topic/setup description (1–2000 characters) requiring no ticker. Hybrid relevance-ranked passages include citations and belief IDs. With view=entities, a directory name query (maximum 80 characters). |
| `kind` | query | `enum` | no | Filter by kind. |
| `belief_id` | query | `string` | no | Return one full belief and its documented analyst twin. Combine with optional as_of and scenario. |
| `context_assessment_id` | query | `string<uuid>` | no | Filter by context_assessment_id. |
| `scenario` | query | `object` | no | JSON encoded object for a belief_id lookup: {"assumptions":[{"condition_id":"ID from the twin","status":"missed"}]}. Maximum eight unique conditions. Catalyst statuses: met, missed, pending, unknown. Invalidation statuses: triggered, not_triggered, pending, unknown. No evidence write or author response prediction; one ordinary belief read is metered. |
| `relationship_paths` | query | `string` | no | Filter by relationship_paths. |
| `visual_id` | query | `string` | no | Filter by visual_id. |
| `visual_offset` | query | `integer` | no | Filter by visual_offset. |
| `region_id` | query | `string` | no | Filter by region_id. |
| `region_offset` | query | `integer` | no | Filter by region_offset. |
| `row_offset` | query | `integer` | no | Filter by row_offset. |
| `row_limit` | query | `integer` | no | Filter by row_limit. |
| `paragraph_index` | query | `integer` | no | Filter by paragraph_index. |
| `support_index` | query | `integer` | no | Filter by support_index. |
| `support_text_offset` | query | `integer` | no | Filter by support_text_offset. |

## Response includes

- Security identity and point in time data status
- Person, thesis, direction, status, confidence, and horizon
- Compact lists, or the complete record selected by belief_id
- Full detail, documented analyst twin, and optional hypothetical condition scenario
- Market confirmation, evidence IDs, detail URLs, and opaque pagination

## Response schemas

### 200 Successful read only response (response variant 1 of 12)

- `billing_notice` (object)
  - `code` ("signup_credit_exhausted", required)
  - `message` (string, required)
  - `remaining_requests` (0, required)
  - `add_credits_url` (string<uri>, required)
  - `plans_url` (string<uri>, required)
- `detail_reference` (string | null, required)
- `schema_version` ("1", required)
- `methodology_version` ("belief-objects-v1", required)
- `resource` ("beliefs", required)
- `view` (risks | catalysts, required)
- `generated_at` (string<date-time>, required)
- `as_of` (string<date-time>, required)
- `objects` (object[], required)
  - `object_id` (string<uuid>, required)
  - `version_id` (string, required)
  - `belief_id` (string<uuid>, required)
  - `statement` (string, required)
  - `statement_ordinal` (integer, required)
  - `effective_at` (string<date-time>, required)
  - `recorded_at` (string<date-time>, required)
  - `status_assessed_at` (string<date-time>, required)
  - `evidence` (object[], required)
    - `citation_id` (string)
    - `evidence_id` (string<uuid>, required)
    - `source_id` (string<uuid>, required)
    - `source_url` (string<uri>, required)
    - `source_title` (string, required)
    - `published_at` (string<date-time>, required)
    - `first_observed_at` (string<date-time>, required)
    - `captured_at` (string<date-time>, required)
    - `content_hash` (string, required)
    - `representation` (string, required)
    - `source_coverage` (full | partial | unknown, required)
    - `support_ids` (string<uuid>[], required)
    - `projection_receipt_id` (string<uuid>)
  - `unknowns` (object[], required)
    - `field` (string, required)
    - `reason` (string, required)
  - `kind` ("risk", required)
  - `status` (open | materialized | resolved | superseded | unknown, required)
  - `severity` (string, required)
  - `severity_basis` (source_stated | engine_assessed | unknown, required)
  - `severity_rationale` (string | null, required)
  - `severity_methodology` (string | null, required)
  - `continuing_relevance` (boolean | null, required)
  - `assessment_id` (string<uuid>)
  - `assessment_cutoff` (string<date-time>)
  - `assessment_available_at` (string<date-time>)
  - `checking_evidence` (object[])
    - `citation_id` (string)
    - `evidence_id` (string<uuid>, required)
    - `source_id` (string<uuid>, required)
    - `source_url` (string<uri>, required)
    - `source_title` (string, required)
    - `published_at` (string<date-time>, required)
    - `first_observed_at` (string<date-time>, required)
    - `captured_at` (string<date-time>, required)
    - `content_hash` (string, required)
    - `representation` (string, required)
    - `source_coverage` (full | partial | unknown, required)
    - `support_ids` (string<uuid>[], required)
    - `projection_receipt_id` (string<uuid>)
- `coverage` (object, required)
  - `available_belief_count` (integer, required)
  - `omitted_belief_count` (integer, required)
  - `unassessed_status_count` (integer, required)
  - `unassessed_severity_count` (integer, required)
  - `history_state` ("unknown", required)
  - `selection_policy` ("current-beliefs-v7", required)
  - `completeness` (complete_within_scope | bounded | no_fit, required)
- `pagination` (object, required)
  - `limit` (integer, required)
  - `returned` (integer, required)
  - `has_more` (boolean, required)
  - `next_cursor` (string | null, required)
- `warnings` (string[], required)

### 200 Successful read only response (response variant 2 of 12)

- `billing_notice` (object)
  - `code` ("signup_credit_exhausted", required)
  - `message` (string, required)
  - `remaining_requests` (0, required)
  - `add_credits_url` (string<uri>, required)
  - `plans_url` (string<uri>, required)
- `schema_version` ("1", required)
- `resource` ("beliefs", required)
- `view` ("track_record", required)
- `generated_at` (string<date-time>, required)
- `as_of` (string<date-time>, required)
- `scope` (object, required)
  - `view` ("track_record", required)
  - `ticker` (string)
  - `entity_id` (string<uuid>)
  - `belief_id` (string<uuid>)
  - `corpus` ("released")
  - `person_id` (string<uuid>, required)
  - `source_id` (string<uuid>)
  - `published_from` (string<date-time>)
  - `published_through` (string<date-time>)
  - `as_of` (string<date-time>)
- `methodology_version` ("author-track-record-v4", required)
- `aggregation` ("equal_weight_non_overlapping_windows_with_verified_exits", required)
- `dividends_and_costs_included` (false, required)
- `history_state` ("unknown", required)
- `observed_belief_count` (integer, required)
- `author` (object, required)
  - `person` (object, required)
    - `id` (string, required)
    - `name` (string, required)
    - `handle` (string | null, required)
  - `observed_belief_count` (integer, required)
  - `unassessed_belief_count` (integer, required)
  - `non_exposure_belief_count` (integer, required)
  - `unmeasured_window_count` (integer, required)
  - `ineligible_window_count` (integer, required)
  - `unpriced_exit_window_count` (integer, required)
  - `cohorts` (object[], required)
    - `action` (buy | hold | short, required)
    - `basis` (recommendation | self_reported_position | self_reported_trade, required)
    - `horizon_sessions` (integer, required)
    - `baseline_method` (next_session_open | source_quote, required)
    - `price_source` (string, required)
    - `benchmark_ticker` ("SPY", required)
    - `benchmark_comparison` ("same_direction_same_sessions", required)
    - `security_ids` (string[], required)
    - `tickers` (string[], required)
    - `measured_count` (integer, required)
    - `sample_count` (integer, required)
    - `unmeasured_window_count` (integer, required)
    - `ineligible_window_count` (integer, required)
    - `exit_adjusted_sample_count` (integer, required)
    - `history_from` (string<date-time>, required)
    - `history_through` (string<date-time>, required)
    - `ranking` (object, required)
      - `status` (insufficient_sample | missing_risk | incomplete_history | provisional | insufficient_peers | ranked, required)
      - `score` (number | null, required)
      - `rank` (integer, required)
      - `peer_count` (integer, required)
      - `sample_weight` (number, required)
      - `components` (object, required)
        - `excess_return` (number | null, required)
        - `profitable_call_rate` (number | null, required)
        - `downside_control` (number | null, required)
      - `profitability` (positive | negative | flat | unmeasured, required)
      - `win_rate_interval_95_percent` (object, required)
        - `lower` (number, required)
        - `upper` (number, required)
      - `reasons` (string[], required)
    - `excluded_repeated_or_overlapping_count` (integer, required)
    - `profitable_count` (integer, required)
    - `losing_count` (integer, required)
    - `flat_count` (integer, required)
    - `win_rate_percent` (number | null, required)
    - `benchmark_outperformance_rate_percent` (number | null, required)
    - `average_return_percent` (number | null, required)
    - `average_benchmark_return_percent` (number | null, required)
    - `average_excess_return_percentage_points` (number | null, required)
    - `median_return_percent` (number | null, required)
    - `worst_return_percent` (number | null, required)
    - `average_maximum_adverse_excursion_percent` (number | null, required)
    - `retrospectively_observed_count` (integer, required)
    - `citation_ids` (string[], required)
- `evidence` (object[], required)
  - `citation_id` (string, required)
  - `evidence_id` (string<uuid>, required)
  - `source_id` (string<uuid>, required)
  - `source_url` (string<uri>, required)
  - `source_title` (string, required)
  - `published_at` (string<date-time>, required)
  - `first_observed_at` (string<date-time>, required)
  - `captured_at` (string<date-time>, required)
  - `content_hash` (string, required)
  - `representation` (string, required)
  - `source_coverage` (full | partial | unknown, required)
  - `support_ids` (string<uuid>[], required)
  - `projection_receipt_id` (string<uuid>)
- `omitted_evidence_count` (integer, required)
- `detail_reference` (string | null, required)
- `limitations` (string[], required)

### 200 Successful read only response (response variant 3 of 12)

- `billing_notice` (object)
  - `code` ("signup_credit_exhausted", required)
  - `message` (string, required)
  - `remaining_requests` (0, required)
  - `add_credits_url` (string<uri>, required)
  - `plans_url` (string<uri>, required)
- `schema_version` ("1", required)
- `generated_at` (string<date-time>, required)
- `as_of` (string<date-time>, required)
- `resource` ("beliefs", required)
- `data_status` (object, required)
  - `mode` (live | preview, required)
  - `freshness` (current | delayed | stale, required)
  - `coverage` (complete | partial | insufficient, required)
  - `latest_observation_at` (string<date-time>, required)
  - `limitations` (string[], required)
- `methodology_versions` (object, required)
  - `belief_dataset` ("belief-dataset-v11", required)
- `citations` (object[], required)
  - `citation_id` (string, required)
  - `evidence_id` (string, required)
  - `source_url` (string<uri>, required)
  - `source_title` (string, required)
  - `author_name` (string, required)
  - `published_at` (string<date-time>, required)
  - `observed_at` (string<date-time>, required)
  - `excerpt` (string, required)
  - `source_text_coverage` (string) Stored source-capture scope. Null or absent means unknown; no value here verifies complete article coverage.
  - `full_document_stored` (boolean | null) Recorded storage flag, separate from verified source completeness. Null or absent means unknown.
  - `source_type` (string, required)
  - `source_provider` (string, required)
  - `source_revision_id` (string, required)
  - `source_content_hash` (string, required)
  - `review_state` (machine_validated | human_reviewed | creator_corrected, required)
- `warnings` (string[], required)
- `data` (object, required)
  - `context_assessment` (object, required)
    - `version` ("evidence-case-context-v1", required)
    - `assessment_id` (string<uuid>, required)
    - `supersedes_assessment_id` (string<uuid>, required)
    - `evidence_id` (string<uuid>, required)
    - `source_revision_id` (string<uuid>, required)
    - `source_content_hash` (string, required)
    - `cutoff` (string<date-time>, required)
    - `assessed_at` (string<date-time>, required)
    - `available_at` (string<date-time>, required)
    - `material_context_gaps` (object, required)
      - `reference_collection` (observed | unknown | not_applicable, required)
      - `unavailable_references` (string[], required)
    - `subjects` (object[], required)
      - `security_id` (string<uuid>, required)
      - `ticker` (string, required)
      - `support` (object[], required)
        - `evidence_id` (string<uuid>, required)
        - `start` (integer, required)
        - `end` (integer, required)
        - `visual_asset_id` (string<uuid>, required)
    - `linked_belief_ids` (string<uuid>[], required)
    - `assessment` (object, required)
      - `summary` (string, required)
      - `source_assertions` (object[], required)
        - `statement` (string, required)
        - `support` (object[], required)
          - `evidence_id` (string<uuid>, required)
          - `start` (integer, required)
          - `end` (integer, required)
          - `visual_asset_id` (string<uuid>, required)
        - `measurement` (object, required)
          - `metric` (string, required)
          - `value` (string | null, required)
          - `unit` (string | null, required)
          - `scale` (string | null, required)
          - `period` (string | null, required)
          - `instrument` (object, required)
            - `kind` (equity | bond | cds | other | unknown, required)
            - `identifier` (string | null, required)
            - `issuer_security_id` (string<uuid>, required)
      - `independently_checked_inputs` (object[], required)
        - `statement` (string, required)
        - `checking_input_indexes` (integer[], required)
      - `case_relationships` (object[], required)
        - `belief_id` (string<uuid>, required)
        - `relation` (supports | contradicts | unresolved | unrelated, required)
        - `explanation` (string, required)
        - `case_paragraph_indexes` (integer[], required)
        - `support` (object[], required)
          - `evidence_id` (string<uuid>, required)
          - `start` (integer, required)
          - `end` (integer, required)
          - `visual_asset_id` (string<uuid>, required)
        - `conditions` (string[], required)
        - `unknowns` (string[], required)
      - `stock_price_mechanism` (object, required)
        - `explanation` (string, required)
        - `support` (object[], required)
          - `evidence_id` (string<uuid>, required)
          - `start` (integer, required)
          - `end` (integer, required)
          - `visual_asset_id` (string<uuid>, required)
        - `checking_input_indexes` (integer[], required)
        - `conditions` (string[], required)
        - `unknowns` (string[], required)
      - `unknowns` (string[], required)
    - `checking_inputs` (object[], required)
      - `kind` ("provider_result", required)
      - `schema_version` ("condition-market-support-v1", required)
      - `result_id` (string, required)
      - `provider` ("alpaca", required)
      - `source_type` ("market_price_snapshot", required)
      - `source_content_hash` (string, required)
      - `facts` (object, required)
        - `ticker` (string, required)
        - `price` (number, required)
        - `market_data_at` (string<date-time>, required)
        - `provider_observed_at` (string<date-time>, required)
        - `feed` (string, required)
    - `dependency_keys` (string[], required)
    - `case_snapshot_hash` (string, required)
    - `retrieval` (object, required)
      - `candidate_count` (integer, required)
      - `case_ids` (string<uuid>[], required)
      - `bounded` (boolean, required)
      - `scope` (string, required)
    - `support` (object[], required)
      - `source_id` (string<uuid>, required)
      - `evidence_id` (string<uuid>, required)
      - `source_revision_id` (string<uuid>, required)
      - `attributed_identity_id` (string<uuid>, required)
      - `source_content_hash` (string, required)
      - `source_url` (string<uri>, required)
      - `published_at` (string<date-time>, required)
      - `revision_published_at` (string<date-time>)
      - `first_observed_at` (string<date-time>, required)
      - `captured_at` (string<date-time>, required)
      - `available_at` (string<date-time>, required)
      - `representation` (source_text | visual_transcription, required)
      - `visual_asset_id` (string<uuid>, required)
      - `quote` (string, required)
      - `start` (integer, required)
      - `end` (integer, required)
      - `literal_text` (allowed | withheld, required)
    - `citation_ids` (string[], required)
  - `visuals` (object)
    - `descriptors` (object[], required)
      - `visual_id` (string, required)
      - `evidence_id` (string, required)
      - `source_id` (string<uuid>, required)
      - `source_revision_id` (string<uuid>, required)
      - `source_content_hash` (string, required)
      - `citation_id` (string, required)
      - `representation` (image | native_table, required)
      - `image_type` (table | chart | text | illustration | mixed | unknown, required)
      - `materiality` (material | non_material | unknown, required)
      - `schema_version` (string | null, required)
      - `available_at` (string<date-time>, required)
      - `availability` (available | after_cutoff | missing | incompatible | legacy_unknown, required)
      - `literal_text` (allowed | withheld, required)
      - `next_region_offset` (integer, required)
      - `regions` (object[], required)
        - `region_id` (string, required)
        - `kind` (text | table | chart, required)
        - `rows` (integer, required)
        - `columns` (integer, required)
    - `next_visual_offset` (integer, required)
    - `selected_region` (object, required)
      - `visual_id` (string, required)
      - `region_id` (string, required)
      - `kind` (text | table | chart, required)
      - `text` (string | null, required)
      - `geometry` (object, required)
        - `coordinate_system` ("normalized-top-left", required)
        - `width` (number, required)
        - `height` (number, required)
      - `row_offset` (integer, required)
      - `row_limit` (integer, required)
      - `total_rows` (integer, required)
      - `has_more` (boolean, required)
      - `cells` (object[], required)
        - `cell_id` (string, required)
        - `row` (integer, required)
        - `column` (integer, required)
        - `text` (string | null, required)
        - `bounds` (number[], required)
        - `row_span` (integer, required)
        - `column_span` (integer, required)
        - `status` (value | blank | unreadable | not_applicable | unknown | legacy_unknown, required)
        - `role` (header | data | footnote | unknown, required)
        - `header_ids` (string[], required)
        - `footnote_ids` (string[], required)
        - `value` (object, required)
          - `decimal` (string, required)
          - `unit` (string | null, required)
          - `currency` (string | null, required)
          - `scale` (string, required)
          - `period` (string | null, required)
          - `scenario` (string | null, required)
          - `support` (literal | derived | estimated | unknown, required)
      - `footnotes` (object[], required)
        - `id` (string, required)
        - `text` (string | null, required)
      - `chart` (object, required)
        - `coverage` (printed_values_only | partial | unreadable | unknown, required)
        - `axes` (object[], required)
          - `label` (string | null, required)
          - `unit` (string | null, required)
        - `series` (object[], required)
          - `label` (string | null, required)
          - `points` (object[], required)
            - `label` (string | null, required)
            - `text` (string | null, required)
            - `value` (object, required)
              - `decimal` (string, required)
              - `unit` (string | null, required)
              - `currency` (string | null, required)
              - `scale` (string, required)
              - `period` (string | null, required)
              - `scenario` (string | null, required)
              - `support` (literal | derived | estimated | unknown, required)
    - `coverage` (available | partial | no_saved_visual_data, required)

### 200 Successful read only response (response variant 4 of 12)

- `billing_notice` (object)
  - `code` ("signup_credit_exhausted", required)
  - `message` (string, required)
  - `remaining_requests` (0, required)
  - `add_credits_url` (string<uri>, required)
  - `plans_url` (string<uri>, required)
- `schema_version` ("1", required)
- `methodology_version` (string, required)
- `generated_at` (string<date-time>, required)
- `as_of` (string<date-time>, required)
- `resource` ("beliefs", required)
- `view` ("compare", required)
- `data` (object, required)
  - `status` (available | unavailable, required)
  - `comparison_focus` (string, required)
  - `source_independence` (object, required) Observed attribution, Evidence, URL, revision and content-hash overlap in the two authorized cases. Different authors, URLs, or Evidence IDs never prove independent research; a supports relation is not independent corroboration.
    - `status` ("not_established", required)
    - `same_attributed_investor` (boolean, required)
    - `shared_evidence_ids` (string[], required)
    - `shared_source_urls` (string<uri>[], required)
    - `shared_source_revision_ids` (string[], required)
    - `shared_source_content_hashes` (string[], required)
    - `explanation` (string, required)
    - `methodology_version` (string, required)
  - `case_snapshot_as_of` (string<date-time>, required)
  - `assessment` (object, required)
    - `id` (string<uuid>, required)
    - `hash` (string, required)
    - `recorded_at` (string<date-time>, required)
    - `model_completion_ids` (string<uuid>[], required)
  - `cases` (object[], required)
    - `belief_id` (string<uuid>, required)
    - `ticker` (string | null, required)
    - `entity_id` (string<uuid>, required)
    - `subject` (string, required)
    - `investor` (string, required)
    - `first_observed_at` (string<date-time>, required)
    - `effective_at` (string<date-time>, required)
    - `time_horizon` (string | null, required)
    - `passages` (object[], required)
      - `passage_id` (string<uuid>, required)
      - `text` (string, required)
      - `available_at` (string<date-time>, required)
      - `citation_ids` (string[], required)
  - `comparison` (object, required)
    - `kind` (supports | contradicts | depends_on | unknown | unrelated, required)
    - `dependency_direction` (string, required)
    - `left_proposition` (string, required)
    - `right_proposition` (string, required)
    - `left_passage_indexes` (integer[], required)
    - `right_passage_indexes` (integer[], required)
    - `relevant_period` (string, required)
    - `rationale` (string, required)
    - `uncertainty` (string[], required)
    - `derivation` ("engine_inferred", required)
    - `from_belief_id` (string<uuid>, required)
    - `to_belief_id` (string<uuid>, required)
    - `left_support_passage_ids` (string<uuid>[], required)
    - `right_support_passage_ids` (string<uuid>[], required)
- `citations` (object[], required)
  - `citation_id` (string, required)
  - `evidence_id` (string, required)
  - `source_url` (string<uri>, required)
  - `source_title` (string, required)
  - `author_name` (string, required)
  - `published_at` (string<date-time>, required)
  - `observed_at` (string<date-time>, required)
  - `excerpt` (string, required)
  - `source_text_coverage` (string) Stored source-capture scope. Null or absent means unknown; no value here verifies complete article coverage.
  - `full_document_stored` (boolean | null) Recorded storage flag, separate from verified source completeness. Null or absent means unknown.
- `limitations` (string[], required)

### 200 Successful read only response (response variant 5 of 12)

- `billing_notice` (object)
  - `code` ("signup_credit_exhausted", required)
  - `message` (string, required)
  - `remaining_requests` (0, required)
  - `add_credits_url` (string<uri>, required)
  - `plans_url` (string<uri>, required)
- `schema_version` ("1", required)
- `methodology_version` (string, required) Search ranking methodology identifier; schema_version governs the response format.
- `generated_at` (string<date-time>, required)
- `as_of` (string<date-time>, required)
- `resource` ("beliefs", required)
- `view` ("search", required)
- `data` (object, required)
  - `matches` (object[], required)
    - `belief_id` (string, required)
    - `ticker` (string | null, required)
    - `entity_id` (string | null, required)
    - `subject` (string, required)
    - `person_id` (string, required)
    - `investor` (string, required)
    - `summary` (string, required)
    - `direction` (string, required)
    - `effective_at` (string<date-time>, required)
    - `first_observed_at` (string<date-time>, required)
    - `rank` (integer, required)
    - `match_basis` (lexical | semantic | hybrid, required)
    - `matched_passages` (object[], required)
      - `passage_id` (string, required)
      - `text` (string, required)
      - `citation_ids` (string[], required)
    - `case_context` (object[], required) Additional cited paragraphs used for the structured relevance support check. These provide case context; they are not separate matches.
      - `passage_id` (string, required)
      - `text` (string, required)
      - `citation_ids` (string[], required)
- `citations` (object[], required)
  - `citation_id` (string, required)
  - `evidence_id` (string, required)
  - `source_url` (string<uri>, required)
  - `source_title` (string, required)
  - `author_name` (string, required)
  - `published_at` (string<date-time>, required)
  - `observed_at` (string<date-time>, required)
  - `excerpt` (string, required)
  - `source_text_coverage` (string) Stored source-capture scope. Null or absent means unknown; no value here verifies complete article coverage.
  - `full_document_stored` (boolean | null) Recorded storage flag, separate from verified source completeness. Null or absent means unknown.
- `coverage` (object, required)
  - `status` (complete | partial, required) Library indexing coverage, not completion of this query. pagination.has_more reports whether further search work remains.
  - `eligible_beliefs` (integer, required)
  - `indexed_beliefs` (integer, required)
  - `scope` ("library")
  - `measurement_status` (current | stale | pending)
  - `as_of` (string<date-time>)
  - `generation` (string<uuid>, required)
  - `model` ("text-embedding-3-small", required)
  - `dimensions` (1536, required)
  - `retrieval` ("hybrid_decisions", required)
  - `relevance_model` ("gpt-6-luna", required)
  - `support_model` (string, required)
  - `observed_at` (string<date-time>)
- `ranking` (object, required)
  - `status` (complete | partial, required)
  - `refused_candidates` (integer, required)
- `pagination` (object, required)
  - `limit` (integer, required)
  - `returned` (integer, required)
  - `has_more` (boolean, required)
  - `next_cursor` (string | null, required)
  - `candidate_window` (40, required)
  - `window_exhausted` (boolean, required)
- `limitations` (string[], required)

### 200 Successful read only response (response variant 6 of 12)

- `billing_notice` (object)
  - `code` ("signup_credit_exhausted", required)
  - `message` (string, required)
  - `remaining_requests` (0, required)
  - `add_credits_url` (string<uri>, required)
  - `plans_url` (string<uri>, required)
- `schema_version` ("1", required)
- `generated_at` (string<date-time>, required)
- `as_of` (string<date-time>, required)
- `resource` ("beliefs", required)
- `data_status` (object, required)
  - `mode` (live | preview, required)
  - `freshness` (current | delayed | stale, required)
  - `coverage` (complete | partial | insufficient, required)
  - `latest_observation_at` (string<date-time>, required)
  - `limitations` (string[], required)
- `methodology_versions` (object, required)
  - `belief_dataset` ("belief-dataset-v11", required)
- `citations` (object[], required)
  - `citation_id` (string, required)
  - `evidence_id` (string, required)
  - `source_url` (string<uri>, required)
  - `source_title` (string, required)
  - `author_name` (string, required)
  - `published_at` (string<date-time>, required)
  - `observed_at` (string<date-time>, required)
  - `excerpt` (string, required)
  - `source_text_coverage` (string) Stored source-capture scope. Null or absent means unknown; no value here verifies complete article coverage.
  - `full_document_stored` (boolean | null) Recorded storage flag, separate from verified source completeness. Null or absent means unknown.
  - `source_type` (string, required)
  - `source_provider` (string, required)
  - `source_revision_id` (string, required)
  - `source_content_hash` (string, required)
  - `review_state` (machine_validated | human_reviewed | creator_corrected, required)
- `warnings` (string[], required)
- `pagination` (object, required)
  - `limit` (integer, required)
  - `returned` (integer, required)
  - `total_available` (integer, required)
  - `total_observed_at` (string<date-time>)
  - `has_more` (boolean, required)
  - `next_cursor` (string | null, required)
  - `next_page_url` (string<uri>, required)
- `data` (object, required)
  - `security` (object, required)
    - `id` (string, required)
    - `ticker` (string, required)
    - `name` (string, required)
  - `beliefs` (object[], required)
    - `position_lifecycle` (object)
      - `methodology_version` ("position-lifecycle-v1", required)
      - `state` (current | expired | closed | unknown, required)
      - `original_published_at` (string<date-time>, required)
      - `last_confirmed_at` (string<date-time>, required)
      - `expires_at` (string<date-time>, required)
      - `original_evaluation_ends_at` (string<date-time>, required)
      - `renewal_event_id` (string | null, required)
      - `citation_ids` (string[], required)
    - `belief_id` (string, required)
    - `security_id` (string, required)
    - `review_state` ("approved", required)
    - `person` (object, required)
      - `id` (string, required)
      - `name` (string, required)
      - `handle` (string, required)
    - `title` (string, required)
    - `summary` (string, required)
    - `direction` (bullish | bearish | mixed | neutral | non_directional | unknown, required)
    - `status` (forming | active | strengthened | weakened | reversed | resolved | abandoned | unknown, required)
    - `confidence` (object, required)
      - `value` (number, required)
      - `basis` (explicit_confidence | inferred_confidence | not_provided, required)
    - `time_horizon` (string, required)
    - `price_context` (object)
      - `article` (object, required)
        - `title` (string, required)
        - `url` (string, required)
        - `published_at` (string<date-time>, required)
        - `first_observed_at` (string<date-time>, required)
        - `captured_at` (string<date-time>, required)
        - `source_revision_id` (string | null, required)
      - `article_price_context` (object, required)
        - `status` (captured | pending | unavailable, required)
        - `reason` (string | null, required)
        - `reference` (object, required)
          - `price` (number, required)
          - `currency` ("USD", required)
          - `anchor_at` (string<date-time>, required)
          - `quote_at` (string<date-time>, required)
          - `quote_lag_milliseconds` (integer, required)
          - `provider_observed_at` (string<date-time>, required)
          - `provider` (string, required)
          - `feed` (string, required)
          - `scope` (consolidated_nbbo | single_feed_context, required)
          - `adjustment` ("unadjusted_quote", required)
          - `observation_hash` (string, required)
          - `methodology_version` (string, required)
        - `basis` ("quote_midpoint_near_publication_or_effective_date", required)
        - `anchor_basis` (publication | effective_date | unavailable, required)
      - `first_observed_price` (object, required)
        - `status` (captured | pending | unavailable, required)
        - `reason` (string | null, required)
        - `reference` (object, required)
          - `price` (number, required)
          - `currency` ("USD", required)
          - `anchor_at` (string<date-time>, required)
          - `quote_at` (string<date-time>, required)
          - `quote_lag_milliseconds` (integer, required)
          - `provider_observed_at` (string<date-time>, required)
          - `provider` (string, required)
          - `feed` (string, required)
          - `scope` (consolidated_nbbo | single_feed_context, required)
          - `adjustment` ("unadjusted_quote", required)
          - `observation_hash` (string, required)
          - `methodology_version` (string, required)
        - `basis` ("quote_midpoint_near_first_observation", required)
      - `capture_price` (object, required)
        - `status` (captured | pending | unavailable, required)
        - `reason` (string | null, required)
        - `reference` (object, required)
          - `price` (number, required)
          - `currency` ("USD", required)
          - `anchor_at` (string<date-time>, required)
          - `quote_at` (string<date-time>, required)
          - `quote_lag_milliseconds` (integer, required)
          - `provider_observed_at` (string<date-time>, required)
          - `provider` (string, required)
          - `feed` (string, required)
          - `scope` (consolidated_nbbo | single_feed_context, required)
          - `adjustment` ("unadjusted_quote", required)
          - `observation_hash` (string, required)
          - `methodology_version` (string, required)
        - `basis` ("quote_midpoint_near_information_capture", required)
      - `requested_price` (object, required)
        - `status` (current | stale | unverified | unavailable, required)
        - `basis` ("adjusted_daily_close", required)
        - `reference` (object, required)
          - `price` (number, required)
          - `currency` ("USD", required)
          - `session_date` (string<date>, required)
          - `provider_observed_at` (string<date-time>, required)
          - `source` (string, required)
          - `observation_hash` (string, required)
        - `as_of` (string<date-time>, required)
        - `market_session` ("latest_completed_daily_session", required)
    - `first_observed_at` (string<date-time>, required)
    - `effective_at` (string<date-time>, required)
    - `latest_revision_at` (string<date-time>, required)
    - `author_intent` (object)
      - `action` (buy | hold | sell | trim | short | cover | avoid_wait | conditional_buy | directional_opinion | derivative | unknown, required)
      - `basis` (recommendation | self_reported_position | self_reported_trade | third_party_report | published_opinion | unknown, required)
      - `time_context` (current | historical | future_conditional | unspecified, required)
      - `instrument` (equity | option | other | unknown, required)
      - `position_actor` (object)
        - `kind` ("author_personal", required)
        - `name` (null, required)
      - `methodology_version` (belief-author-intent-v1 | belief-author-intent-v2 | belief-author-intent-v3, required)
      - `additional_intents` (object[])
        - `action` (buy | hold | sell | trim | short | cover | avoid_wait | conditional_buy | directional_opinion | derivative | unknown, required)
        - `basis` (recommendation | self_reported_position | self_reported_trade | third_party_report | published_opinion | unknown, required)
        - `time_context` (current | historical | future_conditional | unspecified, required)
        - `instrument` (equity | option | other | unknown, required)
        - `position_actor` (object)
          - `kind` ("author_personal", required)
          - `name` (null, required)
        - `conditions` (object[], required)
          - `statement` (string, required)
          - `citation_ids` (string[], required)
        - `citation_ids` (string[], required)
      - `status` (not_assessed | current | superseded, required)
      - `observation_id` (string | null, required)
      - `observed_at` (string<date-time>, required)
      - `conditions` (object[], required)
        - `statement` (string, required)
        - `citation_ids` (string[], required)
      - `citation_ids` (string[], required)
      - `execution_verified` (false, required)
    - `catalyst_summary` (string, required)
    - `risk_summary` (string, required)
    - `claim_count` (integer, required)
    - `revision_count` (integer, required)
    - `condition_counts` (object, required)
      - `catalyst_total` (integer, required)
      - `catalyst_met` (integer, required)
      - `catalyst_missed` (integer, required)
      - `invalidation_total` (integer, required)
      - `invalidation_triggered` (integer, required)
      - `invalidation_not_triggered` (integer, required)
      - `unknown` (integer, required)
    - `outcome_counts` (object, required)
      - `resolved` (integer, required)
      - `pending` (integer, required)
      - `indeterminate` (integer, required)
    - `market_confirmation` (object, required)
      - `standing` (working | flat | against | unknown, required)
      - `direction_adjusted_excess_percent` (number | null, required)
      - `market_data_through` (string<date>, required)
    - `detail_url` (string<uri>, required)
    - `citation_ids` (string[], required)

### 200 Successful read only response (response variant 7 of 12)

- `billing_notice` (object)
  - `code` ("signup_credit_exhausted", required)
  - `message` (string, required)
  - `remaining_requests` (0, required)
  - `add_credits_url` (string<uri>, required)
  - `plans_url` (string<uri>, required)
- `schema_version` ("1", required)
- `generated_at` (string<date-time>, required)
- `as_of` (string<date-time>, required)
- `resource` ("beliefs", required)
- `data_status` (object, required)
  - `mode` (live | preview, required)
  - `freshness` (current | delayed | stale, required)
  - `coverage` (complete | partial | insufficient, required)
  - `latest_observation_at` (string<date-time>, required)
  - `limitations` (string[], required)
- `methodology_versions` (object, required)
  - `belief_dataset` ("belief-dataset-v11", required)
- `citations` (object[], required)
  - `citation_id` (string, required)
  - `evidence_id` (string, required)
  - `source_url` (string<uri>, required)
  - `source_title` (string, required)
  - `author_name` (string, required)
  - `published_at` (string<date-time>, required)
  - `observed_at` (string<date-time>, required)
  - `excerpt` (string, required)
  - `source_text_coverage` (string) Stored source-capture scope. Null or absent means unknown; no value here verifies complete article coverage.
  - `full_document_stored` (boolean | null) Recorded storage flag, separate from verified source completeness. Null or absent means unknown.
  - `source_type` (string, required)
  - `source_provider` (string, required)
  - `source_revision_id` (string, required)
  - `source_content_hash` (string, required)
  - `review_state` (machine_validated | human_reviewed | creator_corrected, required)
- `warnings` (string[], required)
- `data` (object, required)
  - `company_context` (object)
    - `version` ("company-public-context-v1", required)
    - `context_id` (string<uuid>, required)
    - `content_hash` (string, required)
    - `ticker` (string, required)
    - `security_id` (string<uuid>, required)
    - `observed_through` (string<date-time>, required)
    - `available_at` (string<date-time>, required)
    - `findings` (object[], required)
      - `key` (string, required)
      - `status` (verified | does_not_line_up | unknown, required)
      - `statement` (string, required)
      - `value` (number | string | null)
      - `unit` (string)
      - `support` (object[], required)
        - `document_id` (string, required)
        - `content_hash` (string, required)
        - `json_pointer` (string | null, required)
        - `text_span` (object)
          - `start` (integer, required)
          - `end` (integer, required)
    - `research_enrichment` (object)
      - `version` ("retained-research-enrichment-v1", required)
      - `snapshot_captured_at` (string<date-time>, required)
      - `identity_basis` ("observed_ticker_alias", required)
      - `historical_issuer_ownership_verified` (false, required)
      - `financial_status` (available | unavailable | ambiguous, required)
      - `financial_observations` (object[], required)
        - `metric` (string, required)
        - `label` (string, required)
        - `taxonomy` (string, required)
        - `unit` (string, required)
        - `value` (string, required)
        - `start` (string<date>, required)
        - `end` (string<date>, required)
        - `filed` (string<date>, required)
        - `accession` (string, required)
        - `cik` (string, required)
        - `segments` (string | null, required)
        - `reported_quarters` (string, required)
        - `support` (object, required)
          - `document_id` (string, required)
          - `content_hash` (string, required)
          - `json_pointer` (string<starts_with>, required)
          - `text_span` (object)
            - `start` (integer, required)
            - `end` (integer, required)
      - `omitted_financial_observations` (integer, required)
      - `market_status` (available | unavailable | unreconciled, required)
      - `market_as_of` (string<date>, required)
      - `market_ranges` (object[], required)
        - `session_intervals` (integer, required)
        - `from_session` (string<date>, required)
        - `to_session` (string<date>, required)
        - `security_return_pct` (number, required)
        - `benchmark_return_pct` (number, required)
        - `excess_return_pp` (number, required)
        - `basis` ("split_adjusted_close_price_return", required)
        - `support` (object, required)
          - `document_id` (string, required)
          - `content_hash` (string, required)
          - `json_pointer` (string<starts_with>, required)
          - `text_span` (object)
            - `start` (integer, required)
            - `end` (integer, required)
      - `additional_families` (object[])
        - `family` (macro | insider | politician | options | open_interest | short_interest | short_volume | market_reference | institutional_holdings | economic_calendar, required)
        - `status` (available | unavailable | ambiguous | authorization_held, required)
        - `relevance_basis` (issuer_identity | instrument_identity | market_backdrop, required)
        - `records` (object[], required)
          - `record_id` (string, required)
          - `kind` (string, required)
          - `dimensions` (object, required)
          - `measures` (object[], required)
            - `name` (string, required)
            - `value` (string | number | null, required)
            - `unit` (string | null, required)
          - `clocks` (object[], required)
            - `name` (string, required)
            - `role` (period | event | report | expiration | scheduled | observation, required)
            - `value` (string | null, required)
            - `precision` (instant | date | period | unknown, required)
          - `support` (object, required)
            - `document_id` (string, required)
            - `content_hash` (string, required)
            - `json_pointer` (string<starts_with>, required)
            - `text_span` (object)
              - `start` (integer, required)
              - `end` (integer, required)
        - `omitted_records` (integer, required)
        - `held_records` (integer, required)
        - `limitations` (string[], required)
      - `limitations` (string[], required)
    - `issuer_observations` (object[])
      - `type` ("segment_metric", required)
      - `metric` (string, required)
      - `label` (string, required)
      - `definition` (string, required)
      - `basis` (GAAP | IFRS | non_gaap | operational | unknown, required)
      - `dimensions` (object[], required)
        - `kind` (operating_segment | product_or_service | geography | business_line | other, required)
        - `label` (string, required)
      - `period` (object, required)
        - `label` (string, required)
        - `kind` (quarterly | annual | ytd | ttm | instant | other, required)
        - `fiscal_year` (integer, required)
        - `fiscal_quarter` (integer, required)
        - `start_date` (string<date>, required)
        - `end_date` (string<date>, required)
      - `quantity` (object, required)
        - `raw_point` (string, required)
        - `raw_lower` (string, required)
        - `raw_upper` (string, required)
        - `source_scale` (1 | 1000 | 1000000 | 1000000000 | 1000000000000, required)
        - `source_unit` (string, required)
        - `unit` (string, required) Normalized base unit after applying source_scale; source_unit retains the printed unit.
        - `currency` (string, required)
        - `comparator` (equal | approximately | at_least | at_most | less_than | greater_than | range | qualitative, required)
        - `tolerance` (object, required)
          - `raw_value` (string, required)
          - `kind` (relative_percent | absolute | basis_points, required)
        - `point` (string, required)
        - `lower` (string, required)
        - `upper` (string, required)
        - `range_origin` (reported | computed_from_reported_tolerance | none, required)
      - `guidance_status` (string, required)
      - `qualifications` (string[], required)
      - `evidence` (object[], required)
        - `document_id` (string, required)
        - `content_hash` (string, required)
        - `start` (integer, required)
        - `end` (integer, required)
        - `quote` (string, required)
        - `purpose` (value | period | unit | scope | basis | definition | qualification, required)
      - `record_id` (string, required)
      - `source_kind` ("sec_filing_metrics", required)
      - `support` (object, required)
        - `document_id` (string, required)
        - `content_hash` (string, required)
        - `json_pointer` (null, required)
        - `text_span` (object, required)
          - `start` (integer, required)
          - `end` (integer, required)
      - `observed_at` (string<date-time>, required)
      - `period_end` (string<date>, required)
      - `reported_at` (string | null, required)
      - `native_details` (null, required)
      - `extracted_at` (string<date-time>, required)
      - `methodology` ("issuer-metric-grounding-v1", required)
      - `filing` (object, required)
        - `issuer_cik` (string, required)
        - `accession` (string, required)
        - `form` (string, required)
        - `filing_date` (string<date>, required)
        - `accepted_at` (string<date-time>, required)
      - `historical_vintage_verified` (false, required)
      - `comparability` ("not_established", required)
    - `issuer_coverage` (object)
      - `documents` (integer, required)
      - `omissions` (string[], required)
      - `scope` ("provided_documents_only", required)
    - `government_awards` (object, required)
      - `scope` ("sampled_prime_contracts", required)
      - `sampled_count` (integer, required)
      - `has_more` (boolean | null, required)
      - `omitted_record_count` (integer)
      - `records` (object[], required)
        - `award_id` (string | null, required)
        - `generated_internal_id` (string, required)
        - `recipient_name` (string | null, required)
        - `recipient_uei` (string, required)
        - `issuer_association` (verified_direct_recipient | verified_provider_reported_parent_at_observation | unverified_recipient_relationship, required)
        - `legal_ownership_at_award_date` ("unknown", required)
        - `total_obligations_usd` (number | null, required)
        - `total_outlays_usd` (number | null, required)
        - `contract_ceiling_usd` (number | null, required)
        - `awarding_agency` (string | null, required)
        - `performance_start` (string | null, required)
        - `performance_end` (string | null, required)
        - `provider_last_modified_literal` (string | null, required)
        - `original_published_at` (null, required)
        - `support` (object[], required)
          - `document_id` (string, required)
          - `content_hash` (string, required)
          - `json_pointer` (string | null, required)
          - `text_span` (object)
            - `start` (integer, required)
            - `end` (integer, required)
    - `sources` (object[], required)
      - `id` (string, required)
      - `source_id` (string<uuid>, required)
      - `kind` (sec_disclosure | government_award | issuer_disclosure | research_input, required)
      - `title` (string, required)
      - `url` (string<uri>, required)
      - `published_at` (string<date-time>, required)
      - `publication_date` (string<date>, required)
      - `publication_precision` (instant | date | unknown, required)
      - `observed_at` (string<date-time>, required)
      - `content_hash` (string, required)
      - `raw_capture_hash` (string, required)
      - `retained_record_hash` (string, required)
      - `capture_basis` (http_response_bytes | retained_export | retained_case, required)
      - `representation` (provider_json | sec_xbrl | visible_text | retained_research_case, required)
    - `limitations` (string[], required)
  - `business_verification` (object)
    - `version` ("issuer-case-context-v1", required)
    - `status` (available | unavailable, required)
    - `review_scope` (selected_premises | material_business_premises)
    - `belief_id` (string<uuid>, required)
    - `assessment_id` (string<uuid>, required)
    - `case_content_hash` (string, required)
    - `assessed_at` (string<date-time>, required)
    - `information_cutoff` (string<date-time>, required)
    - `match` (object, required)
      - `relation` (supports | contradicts | unresolved | unrelated | no_material_change, required)
      - `explanation` (string, required)
      - `unknowns` (string[], required)
    - `sources` (object[], required)
      - `id` (string, required)
      - `kind` (published_research | issuer | reported_news | market_data | context_assessment | company_data, required)
      - `title` (string, required)
      - `url` (string<uri>, required)
      - `published_at` (string<date-time>, required)
      - `observed_at` (string<date-time>, required)
      - `content_hash` (string, required)
      - `text_coverage` (complete | partial)
    - `limitations` (string[], required)
  - `passage_support` (object)
    - `status` (available | withheld | unavailable, required)
    - `paragraph_index` (integer, required)
    - `support_index` (integer, required)
    - `support_count` (integer, required)
    - `next_support_index` (integer, required)
    - `citation_id` (string | null, required)
    - `evidence_id` (string | null, required)
    - `source_revision_id` (string | null, required)
    - `source_content_hash` (string | null, required)
    - `start_utf16` (integer, required)
    - `end_utf16` (integer, required)
    - `text` (string | null, required)
    - `text_offset` (integer, required)
    - `next_text_offset` (integer, required)
    - `context_before` (string | null, required)
    - `context_after` (string | null, required)
  - `current_market_mark` (object)
    - `status` (current | stale | unavailable, required)
    - `reason` (string, required)
    - `ticker` (string, required)
    - `provider` ("alpaca", required)
    - `feed` (iex | sip, required)
    - `feed_scope` (single_venue | consolidated, required)
    - `basis` (trade | quote_midpoint | minute_bar_close | daily_bar_close | unknown, required)
    - `observed_session` (regular | outside_regular | unknown, required)
    - `adjustment` ("unadjusted_snapshot", required)
    - `timestamp_basis` (trade_time | quote_time | bar_start | unknown, required)
    - `currency` ("USD", required)
    - `price` (number, required)
    - `session_open` (number, required)
    - `market_data_at` (string<date-time>, required)
    - `provider_observed_at` (string<date-time>, required)
    - `available_at` (string<date-time>, required)
    - `observation_hash` (string, required)
    - `benchmark` (object)
      - `status` (current | stale | unavailable, required)
      - `reason` (string, required)
      - `ticker` (string, required)
      - `provider` ("alpaca", required)
      - `feed` (iex | sip, required)
      - `feed_scope` (single_venue | consolidated, required)
      - `basis` (trade | quote_midpoint | minute_bar_close | daily_bar_close | unknown, required)
      - `observed_session` (regular | outside_regular | unknown, required)
      - `adjustment` ("unadjusted_snapshot", required)
      - `timestamp_basis` (trade_time | quote_time | bar_start | unknown, required)
      - `currency` ("USD", required)
      - `price` (number, required)
      - `session_open` (number, required)
      - `market_data_at` (string<date-time>, required)
      - `provider_observed_at` (string<date-time>, required)
      - `available_at` (string<date-time>, required)
      - `observation_hash` (string, required)
    - `research_return_study` (object)
      - `study_id` (string, required)
      - `source_url` (string<uri>, required)
      - `belief_id` (string<uuid>, required)
      - `evidence_id` (string<uuid>, required)
      - `published_at` (string<date-time>, required)
      - `first_observed_at` (string<date-time>, required)
      - `collection_delay_seconds` (number, required)
      - `methodology` (string, required)
      - `thesis_status` ("pending", required)
      - `thesis_status_checked_at` (string<date-time>, required)
      - `latest` (object, required)
        - `status` (current | daily_snapshot | stale | unavailable | incompatible, required)
        - `checked_at` (string<date-time>, required)
        - `security_timestamp` (string<date-time>, required)
        - `benchmark_timestamp` (string<date-time>, required)
        - `timestamp_basis` (trade_time | quote_time | bar_start | unknown, required)
        - `prices` (object, required)
          - `security` (number, required)
          - `benchmark` (number, required)
        - `return_status` (eligible | held, required)
        - `return_reason` (string, required)
        - `split_check_through` ("2026-10-21", required)
      - `entries` (object[], required)
        - `rule` (string, required)
        - `entry_at` (string<date-time>, required)
        - `entry_prices` (object, required)
          - `security` (number, required)
          - `benchmark` (number, required)
        - `retrospective` (true, required)
        - `historical_snapshot` (object, required)
          - `cutoff_at` (string<date-time>, required)
          - `recorded_at` (string<date-time>, required)
          - `exit_prices` (object, required)
            - `security` (number, required)
            - `benchmark` (number, required)
          - `returns` (object, required)
            - `security_pct` (number, required)
            - `benchmark_pct` (number, required)
            - `excess_percentage_points` (number, required)
        - `latest_returns` (object, required)
          - `security_pct` (number, required)
          - `benchmark_pct` (number, required)
          - `excess_percentage_points` (number, required)
      - `display` (string, required)
    - `comparison` (object)
      - `status` (current | stale | unavailable | incompatible, required)
      - `reason` (string, required)
      - `as_of` (string<date-time>, required)
      - `maximum_timestamp_gap_milliseconds` (60000, required)
      - `timestamp_gap_milliseconds` (number, required)
      - `display` (string, required)
  - `context_assessments` (object[])
    - `version` ("evidence-case-context-v1", required)
    - `assessment_id` (string<uuid>, required)
    - `supersedes_assessment_id` (string<uuid>, required)
    - `evidence_id` (string<uuid>, required)
    - `source_revision_id` (string<uuid>, required)
    - `source_content_hash` (string, required)
    - `cutoff` (string<date-time>, required)
    - `assessed_at` (string<date-time>, required)
    - `available_at` (string<date-time>, required)
    - `material_context_gaps` (object, required)
      - `reference_collection` (observed | unknown | not_applicable, required)
      - `unavailable_references` (string[], required)
    - `subjects` (object[], required)
      - `security_id` (string<uuid>, required)
      - `ticker` (string, required)
      - `support` (object[], required)
        - `evidence_id` (string<uuid>, required)
        - `start` (integer, required)
        - `end` (integer, required)
        - `visual_asset_id` (string<uuid>, required)
    - `linked_belief_ids` (string<uuid>[], required)
    - `assessment` (object, required)
      - `summary` (string, required)
      - `source_assertions` (object[], required)
        - `statement` (string, required)
        - `support` (object[], required)
          - `evidence_id` (string<uuid>, required)
          - `start` (integer, required)
          - `end` (integer, required)
          - `visual_asset_id` (string<uuid>, required)
        - `measurement` (object, required)
          - `metric` (string, required)
          - `value` (string | null, required)
          - `unit` (string | null, required)
          - `scale` (string | null, required)
          - `period` (string | null, required)
          - `instrument` (object, required)
            - `kind` (equity | bond | cds | other | unknown, required)
            - `identifier` (string | null, required)
            - `issuer_security_id` (string<uuid>, required)
      - `independently_checked_inputs` (object[], required)
        - `statement` (string, required)
        - `checking_input_indexes` (integer[], required)
      - `case_relationships` (object[], required)
        - `belief_id` (string<uuid>, required)
        - `relation` (supports | contradicts | unresolved | unrelated, required)
        - `explanation` (string, required)
        - `case_paragraph_indexes` (integer[], required)
        - `support` (object[], required)
          - `evidence_id` (string<uuid>, required)
          - `start` (integer, required)
          - `end` (integer, required)
          - `visual_asset_id` (string<uuid>, required)
        - `conditions` (string[], required)
        - `unknowns` (string[], required)
      - `stock_price_mechanism` (object, required)
        - `explanation` (string, required)
        - `support` (object[], required)
          - `evidence_id` (string<uuid>, required)
          - `start` (integer, required)
          - `end` (integer, required)
          - `visual_asset_id` (string<uuid>, required)
        - `checking_input_indexes` (integer[], required)
        - `conditions` (string[], required)
        - `unknowns` (string[], required)
      - `unknowns` (string[], required)
    - `checking_inputs` (object[], required)
      - `kind` ("provider_result", required)
      - `schema_version` ("condition-market-support-v1", required)
      - `result_id` (string, required)
      - `provider` ("alpaca", required)
      - `source_type` ("market_price_snapshot", required)
      - `source_content_hash` (string, required)
      - `facts` (object, required)
        - `ticker` (string, required)
        - `price` (number, required)
        - `market_data_at` (string<date-time>, required)
        - `provider_observed_at` (string<date-time>, required)
        - `feed` (string, required)
    - `dependency_keys` (string[], required)
    - `case_snapshot_hash` (string, required)
    - `retrieval` (object, required)
      - `candidate_count` (integer, required)
      - `case_ids` (string<uuid>[], required)
      - `bounded` (boolean, required)
      - `scope` (string, required)
    - `support` (object[], required)
      - `source_id` (string<uuid>, required)
      - `evidence_id` (string<uuid>, required)
      - `source_revision_id` (string<uuid>, required)
      - `attributed_identity_id` (string<uuid>, required)
      - `source_content_hash` (string, required)
      - `source_url` (string<uri>, required)
      - `published_at` (string<date-time>, required)
      - `revision_published_at` (string<date-time>)
      - `first_observed_at` (string<date-time>, required)
      - `captured_at` (string<date-time>, required)
      - `available_at` (string<date-time>, required)
      - `representation` (source_text | visual_transcription, required)
      - `visual_asset_id` (string<uuid>, required)
      - `quote` (string, required)
      - `start` (integer, required)
      - `end` (integer, required)
      - `literal_text` (allowed | withheld, required)
    - `citation_ids` (string[], required)
  - `security` (object, required)
    - `id` (string, required)
    - `ticker` (string, required)
    - `name` (string, required)
  - `belief` (object, required)
    - `position_lifecycle` (object)
      - `methodology_version` ("position-lifecycle-v1", required)
      - `state` (current | expired | closed | unknown, required)
      - `original_published_at` (string<date-time>, required)
      - `last_confirmed_at` (string<date-time>, required)
      - `expires_at` (string<date-time>, required)
      - `original_evaluation_ends_at` (string<date-time>, required)
      - `renewal_event_id` (string | null, required)
      - `citation_ids` (string[], required)
    - `author_intent` (object)
      - `action` (buy | hold | sell | trim | short | cover | avoid_wait | conditional_buy | directional_opinion | derivative | unknown, required)
      - `basis` (recommendation | self_reported_position | self_reported_trade | third_party_report | published_opinion | unknown, required)
      - `time_context` (current | historical | future_conditional | unspecified, required)
      - `instrument` (equity | option | other | unknown, required)
      - `position_actor` (object)
        - `kind` ("author_personal", required)
        - `name` (null, required)
      - `methodology_version` (belief-author-intent-v1 | belief-author-intent-v2 | belief-author-intent-v3, required)
      - `additional_intents` (object[])
        - `action` (buy | hold | sell | trim | short | cover | avoid_wait | conditional_buy | directional_opinion | derivative | unknown, required)
        - `basis` (recommendation | self_reported_position | self_reported_trade | third_party_report | published_opinion | unknown, required)
        - `time_context` (current | historical | future_conditional | unspecified, required)
        - `instrument` (equity | option | other | unknown, required)
        - `position_actor` (object)
          - `kind` ("author_personal", required)
          - `name` (null, required)
        - `conditions` (object[], required)
          - `statement` (string, required)
          - `citation_ids` (string[], required)
        - `citation_ids` (string[], required)
      - `status` (not_assessed | current | superseded, required)
      - `observation_id` (string | null, required)
      - `observed_at` (string<date-time>, required)
      - `conditions` (object[], required)
        - `statement` (string, required)
        - `citation_ids` (string[], required)
      - `citation_ids` (string[], required)
      - `execution_verified` (false, required)
    - `belief_id` (string, required)
    - `security_id` (string, required)
    - `review_state` ("approved", required)
    - `person` (object, required)
      - `id` (string, required)
      - `name` (string, required)
      - `handle` (string, required)
    - `title` (string, required)
    - `summary` (string, required)
    - `direction` (bullish | bearish | mixed | neutral | non_directional | unknown, required)
    - `investment_case` (object)
      - `schema_version` ("investment-case-v1", required)
      - `relationships` (object[])
        - `schema_version` ("belief-relationship-v1", required)
        - `kind` (supports | contradicts | depends_on | exposure | causal_mechanism, required)
        - `from_entity_id` (string<uuid>, required)
        - `to_entity_id` (string<uuid>, required)
        - `statement` (string, required)
        - `derivation` (source_explicit | source_implied | engine_inferred, required) source_explicit is directly stated; source_implied follows the source argument; engine_inferred is BeliefState's inference and must never become the author's view.
        - `relevant_period` (string, required)
        - `uncertainty` (string, required)
        - `available_at` (string<date-time>, required) Availability of the returned case and endpoint support at the requested cutoff.
        - `citation_ids` (string[], required) Originating source Evidence supporting this relationship statement.
        - `identity_citation_ids` (string[], required) Endpoint identity support; these citations do not independently establish the relationship statement.
      - `source_relationships` (object[])
        - `schema_version` ("source-mention-relationship-v1", required)
        - `relationship_index` (integer, required)
        - `identity_status` ("source_mention_only", required)
        - `from` (object, required)
          - `asset_kind` (company | security | sector | theme | commodity | index | currency | macro_variable | industry | country | geography | person | policy | event_series | event_occurrence | other, required)
          - `source_text` (string, required)
          - `asset_ordinal` (integer, required)
        - `to` (object, required)
          - `asset_kind` (company | security | sector | theme | commodity | index | currency | macro_variable | industry | country | geography | person | policy | event_series | event_occurrence | other, required)
          - `source_text` (string, required)
          - `asset_ordinal` (integer, required)
        - `kind` (supports | contradicts | depends_on | exposure | causal_mechanism, required)
        - `statement` (string, required)
        - `derivation` (source_explicit | source_implied | engine_inferred, required)
        - `relevant_period` (string, required)
        - `uncertainty` (string, required)
        - `available_at` (string<date-time>, required)
        - `citation_ids` (string[], required)
      - `relationship_paths` (object)
        - `scope` ("originating_case", required)
        - `coverage` (unknown | within_case | incomplete, required)
        - `max_depth` (integer, required)
        - `edge_budget` (integer, required)
        - `truncated` (boolean, required) True when the requested edge-step budget prevents completing traversal within the requested depth.
        - `paths` (object[], required)
          - `edge_indexes` (integer[], required) Ordered indexes into this investment_case.relationships list. Every intermediate edge remains present with its separate source/identity citations and derivation.
          - `derivation` ("engine_inferred", required) The sequence is BeliefState's composition, never a source-authored causal conclusion. Individual edge derivation remains unchanged.
          - `available_at` (string<date-time>, required)
        - `limitations` (string[], required)
        - `methodology_version` ("case-relationship-traversal-v1", required)
      - `relationship_coverage` (unknown | direct_links_collected | incomplete) Bounded direct links within this originating case. Absent or unknown means collection is unknown; incomplete means some support or endpoints are unavailable. No multi-hop completeness, causal magnitude or portfolio weights are claimed.
      - `paragraphs` (object[], required)
        - `text` (string, required)
        - `citation_ids` (string[], required)
        - `paragraph_index` (integer)
        - `support_count` (integer)
        - `support_status` (verified | partial | unavailable)
    - `status` (forming | active | strengthened | weakened | reversed | resolved | abandoned | unknown, required)
    - `confidence` (object, required)
      - `value` (number, required)
      - `basis` (explicit_confidence | inferred_confidence | not_provided, required)
    - `time_horizon` (string, required)
    - `price_context` (object)
      - `article` (object, required)
        - `title` (string, required)
        - `url` (string, required)
        - `published_at` (string<date-time>, required)
        - `first_observed_at` (string<date-time>, required)
        - `captured_at` (string<date-time>, required)
        - `source_revision_id` (string | null, required)
      - `article_price_context` (object, required)
        - `status` (captured | pending | unavailable, required)
        - `reason` (string | null, required)
        - `reference` (object, required)
          - `price` (number, required)
          - `currency` ("USD", required)
          - `anchor_at` (string<date-time>, required)
          - `quote_at` (string<date-time>, required)
          - `quote_lag_milliseconds` (integer, required)
          - `provider_observed_at` (string<date-time>, required)
          - `provider` (string, required)
          - `feed` (string, required)
          - `scope` (consolidated_nbbo | single_feed_context, required)
          - `adjustment` ("unadjusted_quote", required)
          - `observation_hash` (string, required)
          - `methodology_version` (string, required)
        - `basis` ("quote_midpoint_near_publication_or_effective_date", required)
        - `anchor_basis` (publication | effective_date | unavailable, required)
      - `first_observed_price` (object, required)
        - `status` (captured | pending | unavailable, required)
        - `reason` (string | null, required)
        - `reference` (object, required)
          - `price` (number, required)
          - `currency` ("USD", required)
          - `anchor_at` (string<date-time>, required)
          - `quote_at` (string<date-time>, required)
          - `quote_lag_milliseconds` (integer, required)
          - `provider_observed_at` (string<date-time>, required)
          - `provider` (string, required)
          - `feed` (string, required)
          - `scope` (consolidated_nbbo | single_feed_context, required)
          - `adjustment` ("unadjusted_quote", required)
          - `observation_hash` (string, required)
          - `methodology_version` (string, required)
        - `basis` ("quote_midpoint_near_first_observation", required)
      - `capture_price` (object, required)
        - `status` (captured | pending | unavailable, required)
        - `reason` (string | null, required)
        - `reference` (object, required)
          - `price` (number, required)
          - `currency` ("USD", required)
          - `anchor_at` (string<date-time>, required)
          - `quote_at` (string<date-time>, required)
          - `quote_lag_milliseconds` (integer, required)
          - `provider_observed_at` (string<date-time>, required)
          - `provider` (string, required)
          - `feed` (string, required)
          - `scope` (consolidated_nbbo | single_feed_context, required)
          - `adjustment` ("unadjusted_quote", required)
          - `observation_hash` (string, required)
          - `methodology_version` (string, required)
        - `basis` ("quote_midpoint_near_information_capture", required)
      - `requested_price` (object, required)
        - `status` (current | stale | unverified | unavailable, required)
        - `basis` ("adjusted_daily_close", required)
        - `reference` (object, required)
          - `price` (number, required)
          - `currency` ("USD", required)
          - `session_date` (string<date>, required)
          - `provider_observed_at` (string<date-time>, required)
          - `source` (string, required)
          - `observation_hash` (string, required)
        - `as_of` (string<date-time>, required)
        - `market_session` ("latest_completed_daily_session", required)
    - `first_observed_at` (string<date-time>, required)
    - `effective_at` (string<date-time>, required)
    - `latest_revision_at` (string<date-time>, required)
    - `claims` (object[], required)
      - `assessment` (object)
        - `claim_id` (string, required)
        - `claim_type` (string, required)
        - `as_of` (string<date-time>, required)
        - `author_horizon` (string | null, required)
        - `expected_by` (string<date-time>, required)
        - `assessment_kind` (factual | subjective | forecast | unclassified, required)
        - `factual_support` (not_applicable | unverified | supported | partially_supported | contradicted | subjective, required)
        - `forecast_status` (not_applicable | pending | overdue_unverified | horizon_unknown | partially_resolved | resolved, required)
        - `forecast_outcome` (string, required)
        - `research_check_status` (not_reviewed | current | stale | inputs_changed, required)
        - `research_verdict` (string, required)
        - `research_checked_at` (string<date-time>, required)
        - `research_evidence` (object[], required)
          - `document_id` (string, required)
          - `quote` (string, required)
          - `source_url` (string<uri>, required)
          - `published_at` (string<date-time>, required)
          - `publication_time_basis` ("filing_date_or_observation_bound", required)
          - `content_hash` (string, required)
          - `start` (integer, required)
          - `end` (integer, required)
        - `condition_results` (object[], required)
          - `condition_id` (string, required)
          - `status` (pending | met | missed | not_triggered | triggered | unknown, required)
          - `route` (market_price | financial_statements | sec_filing | company_release | regulatory | news | unknown, required)
          - `checked_at` (string<date-time>, required)
          - `source_url` (string<uri>, required)
          - `source_published_at` (string<date-time>, required)
          - `expected_by` (string<date-time>, required)
          - `counts_as_resolution` (boolean, required)
        - `limitations` (string[], required)
      - `claim_id` (string, required)
      - `review_state` ("approved", required)
      - `type` (fact | estimate | causal_inference | forecast | opinion | catalyst | risk | invalidation | valuation | target | position_statement | other, required)
      - `statement` (string, required)
      - `subject` (string, required)
      - `predicate` (string, required)
      - `object` (string, required)
      - `value` (string, required)
      - `unit` (string, required)
      - `currency` (string, required)
      - `qualifiers` (object)
      - `time_horizon` (string, required)
      - `confidence` (object, required)
        - `value` (number, required)
        - `basis` (explicit_confidence | inferred_confidence | not_provided, required)
      - `citation_ids` (string[], required)
    - `revisions` (object[], required)
      - `revision_id` (string, required)
      - `type` (expanded | conviction_increased | catalyst_changed | risk_appeared | conviction_reduced | reversed | closed, required)
      - `title` (string, required)
      - `summary` (string, required)
      - `effective_at` (string<date-time>, required)
      - `direction_after` (bullish | bearish | mixed | neutral | non_directional | unknown, required)
      - `confidence_after` (number, required)
      - `confidence_changed` (boolean, required)
      - `terminal_reason` (string, required)
      - `citation_ids` (string[], required)
    - `condition_states` (object[], required)
      - `assessment` (object) Qualification at this read cutoff, separate from the unchanged recorded status. Provider capability describes supported inputs, not enabled monitoring. A current check does not validate the whole investment case.
        - `state` (not_checked | checked_unknown | unqualified | superseded | stale | current | historically_resolved, required)
        - `usable_as_current` (boolean, required)
        - `assessed_at` (string<date-time>, required)
        - `provider_capability` (share_price | sec_issuer | unsupported, required)
        - `reason` (string, required)
        - `methodology_version` ("condition-read-qualification-v1", required)
      - `checking_support` (object)
        - `lineage` ("retained_provider_result", required)
        - `result` (object, required)
          - `kind` ("provider_result", required)
          - `schema_version` ("condition-market-support-v1", required)
          - `result_id` (string, required)
          - `provider` ("alpaca", required)
          - `source_type` ("market_price_snapshot", required)
          - `source_content_hash` (string, required)
          - `facts` (object, required)
            - `ticker` (string, required)
            - `price` (number, required)
            - `market_data_at` (string<date-time>, required)
            - `provider_observed_at` (string<date-time>, required)
            - `feed` (string, required)
      - `condition_match` (object)
        - `schema_version` ("condition-match-v1", required)
        - `condition_id` (string<uuid>, required)
        - `condition_key` (string, required)
        - `status` (pending | met | missed | not_triggered | triggered | unknown, required)
        - `support_hash` (string, required)
        - `dimensions` (object, required)
          - `proposition` (object, required)
            - `assessment` (matched | mismatched | unknown | not_applicable, required)
            - `rationale` (string, required)
          - `entity` (object, required)
            - `assessment` (matched | mismatched | unknown | not_applicable, required)
            - `rationale` (string, required)
          - `reporting_period` (object, required)
            - `assessment` (matched | mismatched | unknown | not_applicable, required)
            - `rationale` (string, required)
          - `unit` (object, required)
            - `assessment` (matched | mismatched | unknown | not_applicable, required)
            - `rationale` (string, required)
          - `consequence` (object, required)
            - `assessment` (matched | mismatched | unknown | not_applicable, required)
            - `rationale` (string, required)
      - `historical_resolution` (object)
        - `resolved_on` (string<date>, required)
        - `rationale` (string, required)
        - `schema_version` ("condition-historical-resolution-v1", required)
        - `condition_id` (string<uuid>, required)
        - `condition_key` (string, required)
        - `status` (met | missed, required)
        - `support_hash` (string, required)
      - `condition_id` (string, required)
      - `originating_evidence_id` (string, required)
      - `originating_claim_id` (string, required)
      - `kind` (catalyst | invalidation, required)
      - `statement` (string, required)
      - `observation_plan` (object, required)
        - `monitoring_plan_review` (object)
          - `recorded_at` (string<date-time>, required)
          - `reason` (string, required)
        - `classification_status` (valid | unrouted | legacy_invalid, required)
        - `route` (market_price | financial_statements | sec_filing | company_release | regulatory | news | unknown, required)
        - `evaluation_mode` (numeric | event | deadline | unknown, required)
        - `metric` (string, required)
        - `operator` (string, required)
        - `target_value` (number | null, required)
        - `target_text` (string, required)
        - `unit` (string, required)
        - `compiler` (object, required)
          - `method` (string, required)
          - `model_version` (string, required)
          - `prompt_version` (string, required)
          - `schema_version` (string, required)
      - `status` (pending | met | missed | not_triggered | triggered | unknown, required)
      - `expected_by` (string<date-time>, required)
      - `observed_value` (number | null, required)
      - `observed_text` (string, required)
      - `explanation` (string, required)
      - `confidence` (number, required)
      - `last_checked_at` (string<date-time>, required)
      - `last_successful_inspection_at` (string<date-time>)
      - `source` (object, required)
        - `provider` (string, required)
        - `url` (string<uri>, required)
        - `title` (string, required)
        - `published_at` (string<date-time>, required)
    - `outcomes` (object[], required)
      - `performance_assessment` (object)
        - `measurement_status` (measured | pending | unavailable, required)
        - `evaluation_status` (evaluated | pending | not_eligible, required)
        - `baseline_method` (string, required)
        - `interpretation` (object, required)
          - `action` (buy | hold | sell | trim | short | cover | avoid_wait | conditional_buy | directional_opinion | derivative | unknown, required)
          - `basis` (recommendation | self_reported_position | self_reported_trade | third_party_report | published_opinion | unknown, required)
          - `timeContext` (current | historical | future_conditional | unspecified, required)
          - `instrument` (equity | option | other | unknown, required)
          - `comparison` (hypothetical_long | hypothetical_short | hypothetical_cash_avoidance | stock_price_context, required)
          - `reason` (string, required)
          - `actualProfitVerified` (false, required)
          - `thesisResolution` ("not_evaluated", required)
          - `priceReturnResolvesThesis` (false, required)
          - `dividendsAndCostsIncluded` (false, required)
          - `cashYieldIncluded` (false, required)
          - `avoidedLossPercent` (number | null, required)
          - `cashVsBenchmarkPercent` (number | null, required)
        - `measures` ("hypothetical_publication_based_price_performance", required)
        - `verifies_claim_truth` (false, required)
        - `verifies_author_profit` (false, required)
      - `anchor_type` (initial_belief | revision, required)
      - `revision_id` (string, required)
      - `horizon_sessions` (number, required)
      - `horizon_unit` ("completed_us_trading_sessions", required)
      - `status` (resolved | pending | indeterminate, required)
      - `label` (correct | incorrect | mixed | unknown, required)
      - `hit` (boolean | null, required)
      - `confidence_snapshot` (number, required)
      - `baseline_at` (string<date-time>, required)
      - `outcome_at` (string<date-time>, required)
      - `security_return_percent` (number | null, required)
      - `benchmark_return_percent` (number | null, required)
      - `direction_adjusted_excess_percent` (number | null, required)
      - `maximum_favorable_excursion_percent` (number | null, required)
      - `maximum_adverse_excursion_percent` (number | null, required)
      - `time_profitable_percent` (number, required)
      - `path_efficiency_percent` (number, required)
      - `volatility_adjusted_return` (number | null, required)
      - `benchmark_ticker` ("SPY", required)
      - `price_source` (string, required)
      - `market_data_through` (string<date>, required)
      - `observed_at` (string<date-time>, required)
      - `methodology_version` (string, required)
    - `since_inception` (object, required)
      - `performance_assessment` (object)
        - `measurement_status` (measured | pending | unavailable, required)
        - `evaluation_status` (evaluated | pending | not_eligible, required)
        - `baseline_method` (string, required)
        - `interpretation` (object, required)
          - `action` (buy | hold | sell | trim | short | cover | avoid_wait | conditional_buy | directional_opinion | derivative | unknown, required)
          - `basis` (recommendation | self_reported_position | self_reported_trade | third_party_report | published_opinion | unknown, required)
          - `timeContext` (current | historical | future_conditional | unspecified, required)
          - `instrument` (equity | option | other | unknown, required)
          - `comparison` (hypothetical_long | hypothetical_short | hypothetical_cash_avoidance | stock_price_context, required)
          - `reason` (string, required)
          - `actualProfitVerified` (false, required)
          - `thesisResolution` ("not_evaluated", required)
          - `priceReturnResolvesThesis` (false, required)
          - `dividendsAndCostsIncluded` (false, required)
          - `cashYieldIncluded` (false, required)
          - `avoidedLossPercent` (number | null, required)
          - `cashVsBenchmarkPercent` (number | null, required)
        - `measures` ("hypothetical_publication_based_price_performance", required)
        - `verifies_claim_truth` (false, required)
        - `verifies_author_profit` (false, required)
      - `anchor_type` (initial_belief | revision, required)
      - `revision_id` (string, required)
      - `status` (measured | pending | indeterminate, required)
      - `standing` (working | flat | against | unknown, required)
      - `completed_sessions` (integer, required)
      - `baseline_at` (string<date-time>, required)
      - `current_at` (string<date-time>, required)
      - `baseline_price` (number, required)
      - `current_price` (number, required)
      - `security_return_percent` (number | null, required)
      - `benchmark_return_percent` (number | null, required)
      - `direction_adjusted_return_percent` (number | null, required)
      - `direction_adjusted_excess_percent` (number | null, required)
      - `maximum_favorable_excursion_percent` (number | null, required)
      - `maximum_adverse_excursion_percent` (number | null, required)
      - `time_profitable_percent` (number, required)
      - `path_efficiency_percent` (number, required)
      - `volatility_adjusted_return` (number | null, required)
      - `benchmark_ticker` ("SPY", required)
      - `price_source` (string, required)
      - `market_data_through` (string<date>, required)
      - `observed_at` (string<date-time>, required)
      - `methodology_version` (string, required)
    - `provenance` (object, required)
      - `thesis_cluster_id` (string, required)
      - `model_version` (string, required)
      - `prompt_version` (string, required)
      - `lineage_role` (originator | specialist_adoption | generalist_adoption | unknown, required)
      - `independent_source_count` (integer, required)
    - `citation_ids` (string[], required)
  - `decision_review` (object, required)
    - `status` (not_reviewed | current | stale | inputs_changed, required)
    - `conclusion` (string, required)
    - `research_check` (object, required)
      - `checked_at` (string<date-time>, required)
      - `evidence_observed_at` (string<date-time>, required)
      - `issuer_context_hash` (string, required)
      - `thesis_input_hash` (string, required)
      - `model` (string, required)
      - `decision_assessment` (object, required)
        - `usefulness` (insufficient_evidence | adds_context | changes_risk_assessment | changes_thesis_assessment, required)
        - `conclusion` (string, required)
        - `next_checks` (string[], required)
      - `material_context` (object[], required)
        - `statement` (string, required)
        - `relevance` (string, required)
        - `evidence` (object[], required)
          - `document_id` (string, required)
          - `quote` (string, required)
          - `source_url` (string<uri>, required)
          - `published_at` (string<date-time>, required)
          - `publication_time_basis` ("filing_date_or_observation_bound", required)
          - `content_hash` (string, required)
          - `start` (integer, required)
          - `end` (integer, required)
      - `checks` (object[], required)
        - `claim_id` (string, required)
        - `verdict` (supported | partially_supported | contradicted | not_yet_testable | subjective | unverified, required)
        - `explanation` (string, required)
        - `evidence` (object[], required)
          - `document_id` (string, required)
          - `quote` (string, required)
          - `source_url` (string<uri>, required)
          - `published_at` (string<date-time>, required)
          - `publication_time_basis` ("filing_date_or_observation_bound", required)
          - `content_hash` (string, required)
          - `start` (integer, required)
          - `end` (integer, required)
        - `statement` (string, required)
      - `selected_claim_count` (integer, required)
      - `total_claim_count` (integer, required)
      - `missing_information` (string[], required)
      - `author_followup` (object, required)
        - `status` (newer_material_found | no_newer_items_in_feed_window | not_verified | fetch_failed, required)
        - `checked_at` (string<date-time>, required)
        - `feed_url` (string<uri>, required)
        - `window_start` (string<date-time>, required)
        - `window_end` (string<date-time>, required)
        - `newer_items` (object[], required)
          - `title` (string, required)
          - `url` (string<uri>, required)
          - `published_at` (string<date-time>, required)
        - `scope` ("public_feed_metadata_only", required)
        - `limitation` (string, required)
      - `methodology_version` ("thesis-research-check-v4", required)
  - `investor_twin` (object)
    - `methodology_version` ("documented-investor-twin-v1", required)
    - `snapshot_id` (string, required)
    - `as_of` (string<date-time>, required)
    - `scope` ("selected_beliefs", required)
    - `person` (object, required)
      - `id` (string, required)
      - `name` (string, required)
      - `handle` (string | null, required)
    - `ticker` (string, required)
    - `documented_state` (object[], required)
      - `belief_id` (string, required)
      - `title` (string, required)
      - `summary` (string, required)
      - `direction` (string, required)
      - `status` (string, required)
      - `confidence` (object, required)
        - `value` (number, required)
        - `basis` (string, required)
      - `time_horizon` (string | null, required)
      - `latest_revision_at` (string<date-time>, required)
      - `citation_ids` (string[], required)
    - `memories` (object[], required)
      - `id` (string, required)
      - `belief_id` (string, required)
      - `kind` (belief | claim | revision, required)
      - `text` (string, required)
      - `observed_at` (string<date-time>, required)
      - `citation_ids` (string[], required)
      - `importance` (number, required)
    - `conditions` (object[], required)
      - `condition_id` (string, required)
      - `belief_id` (string, required)
      - `kind` (catalyst | invalidation, required)
      - `statement` (string, required)
      - `status` (pending | met | missed | triggered | not_triggered | unknown, required)
      - `last_checked_at` (string<date-time>, required)
      - `citation_ids` (string[], required)
    - `author_observed_through` (string<date-time>, required)
    - `conditions_observed_through` (string<date-time>, required)
    - `behavioral_forecast` (null, required)
    - `limitations` (string[], required)
  - `scenario` (object)
    - `kind` ("hypothetical_condition_scenario", required)
    - `snapshot_id` (string, required)
    - `as_of` (string<date-time>, required)
    - `changes` (object[], required)
      - `condition_id` (string, required)
      - `belief_id` (string, required)
      - `kind` (catalyst | invalidation, required)
      - `statement` (string, required)
      - `status` (pending | met | missed | triggered | not_triggered | unknown, required)
      - `last_checked_at` (string<date-time>, required)
      - `citation_ids` (string[], required)
      - `observed_status` (pending | met | missed | triggered | not_triggered | unknown, required)
      - `assumed_status` (pending | met | missed | triggered | not_triggered | unknown, required)
      - `implication` (string, required)
    - `author_state_changed` (false, required)
    - `behavioral_forecast` (null, required)
    - `limitation` (string, required)
  - `visuals` (object)
    - `descriptors` (object[], required)
      - `visual_id` (string, required)
      - `evidence_id` (string, required)
      - `source_id` (string<uuid>, required)
      - `source_revision_id` (string<uuid>, required)
      - `source_content_hash` (string, required)
      - `citation_id` (string, required)
      - `representation` (image | native_table, required)
      - `image_type` (table | chart | text | illustration | mixed | unknown, required)
      - `materiality` (material | non_material | unknown, required)
      - `schema_version` (string | null, required)
      - `available_at` (string<date-time>, required)
      - `availability` (available | after_cutoff | missing | incompatible | legacy_unknown, required)
      - `literal_text` (allowed | withheld, required)
      - `next_region_offset` (integer, required)
      - `regions` (object[], required)
        - `region_id` (string, required)
        - `kind` (text | table | chart, required)
        - `rows` (integer, required)
        - `columns` (integer, required)
    - `next_visual_offset` (integer, required)
    - `selected_region` (object, required)
      - `visual_id` (string, required)
      - `region_id` (string, required)
      - `kind` (text | table | chart, required)
      - `text` (string | null, required)
      - `geometry` (object, required)
        - `coordinate_system` ("normalized-top-left", required)
        - `width` (number, required)
        - `height` (number, required)
      - `row_offset` (integer, required)
      - `row_limit` (integer, required)
      - `total_rows` (integer, required)
      - `has_more` (boolean, required)
      - `cells` (object[], required)
        - `cell_id` (string, required)
        - `row` (integer, required)
        - `column` (integer, required)
        - `text` (string | null, required)
        - `bounds` (number[], required)
        - `row_span` (integer, required)
        - `column_span` (integer, required)
        - `status` (value | blank | unreadable | not_applicable | unknown | legacy_unknown, required)
        - `role` (header | data | footnote | unknown, required)
        - `header_ids` (string[], required)
        - `footnote_ids` (string[], required)
        - `value` (object, required)
          - `decimal` (string, required)
          - `unit` (string | null, required)
          - `currency` (string | null, required)
          - `scale` (string, required)
          - `period` (string | null, required)
          - `scenario` (string | null, required)
          - `support` (literal | derived | estimated | unknown, required)
      - `footnotes` (object[], required)
        - `id` (string, required)
        - `text` (string | null, required)
      - `chart` (object, required)
        - `coverage` (printed_values_only | partial | unreadable | unknown, required)
        - `axes` (object[], required)
          - `label` (string | null, required)
          - `unit` (string | null, required)
        - `series` (object[], required)
          - `label` (string | null, required)
          - `points` (object[], required)
            - `label` (string | null, required)
            - `text` (string | null, required)
            - `value` (object, required)
              - `decimal` (string, required)
              - `unit` (string | null, required)
              - `currency` (string | null, required)
              - `scale` (string, required)
              - `period` (string | null, required)
              - `scenario` (string | null, required)
              - `support` (literal | derived | estimated | unknown, required)
    - `coverage` (available | partial | no_saved_visual_data, required)

### 200 Successful read only response (response variant 8 of 12)

- `billing_notice` (object)
  - `code` ("signup_credit_exhausted", required)
  - `message` (string, required)
  - `remaining_requests` (0, required)
  - `add_credits_url` (string<uri>, required)
  - `plans_url` (string<uri>, required)
- `schema_version` ("1", required)
- `generated_at` (string<date-time>, required)
- `as_of` (string<date-time>, required)
- `resource` ("beliefs", required)
- `data_status` (object, required)
  - `mode` (live | preview, required)
  - `freshness` (current | delayed | stale, required)
  - `coverage` (complete | partial | insufficient, required)
  - `latest_observation_at` (string<date-time>, required)
  - `limitations` (string[], required)
- `methodology_versions` (object, required)
  - `belief_dataset` ("belief-dataset-v11", required)
- `citations` (object[], required)
  - `citation_id` (string, required)
  - `evidence_id` (string, required)
  - `source_url` (string<uri>, required)
  - `source_title` (string, required)
  - `author_name` (string, required)
  - `published_at` (string<date-time>, required)
  - `observed_at` (string<date-time>, required)
  - `excerpt` (string, required)
  - `source_text_coverage` (string) Stored source-capture scope. Null or absent means unknown; no value here verifies complete article coverage.
  - `full_document_stored` (boolean | null) Recorded storage flag, separate from verified source completeness. Null or absent means unknown.
  - `source_type` (string, required)
  - `source_provider` (string, required)
  - `source_revision_id` (string, required)
  - `source_content_hash` (string, required)
  - `review_state` (machine_validated | human_reviewed | creator_corrected, required)
- `warnings` (string[], required)
- `pagination` (object, required)
  - `limit` (integer, required)
  - `returned` (integer, required)
  - `total_available` (integer, required)
  - `total_observed_at` (string<date-time>)
  - `has_more` (boolean, required)
  - `next_cursor` (string | null, required)
  - `next_page_url` (string<uri>, required)
- `data` (object, required)
  - `security` (null, required)
  - `entity` (object, required)
    - `entity_id` (string<uuid>, required)
    - `kind` (company | instrument | commodity | macro_variable | industry | sector | theme | country | geography | person | policy | event_series | event_occurrence | currency | index, required)
    - `namespace` (string, required)
    - `canonical_key` (string, required)
    - `name` (string, required)
    - `security_id` (string<uuid>, required)
    - `parent_entity_id` (string<uuid>, required)
    - `recorded_at` (string<date-time>, required)
    - `available_at` (string<date-time>, required)
    - `release_effective_at` (string<date-time>, required)
    - `aliases` (object[], required)
      - `alias` (string, required)
      - `assertion_id` (string<uuid>, required)
      - `evidence_id` (string, required)
      - `confidence` (number, required)
      - `available_at` (string<date-time>, required)
      - `citation_ids` (string[], required)
  - `capabilities` (object, required)
    - `market_price` (object, required)
      - `available` (false, required)
      - `reason` (string, required)
    - `benchmark_return` (object, required)
      - `available` (false, required)
      - `reason` (string, required)
  - `research_enrichment` (object)
    - `version` ("retained-subject-enrichment-v1", required)
    - `entity_id` (string<uuid>, required)
    - `relevance_basis` ("market_backdrop", required)
    - `subject_exposure` ("not_established", required)
    - `snapshot_captured_at` (string<date-time>, required)
    - `available_at` (string<date-time>, required)
    - `records` (object[], required)
      - `record_id` (string, required)
      - `kind` (string, required)
      - `dimensions` (object, required)
      - `measures` (object[], required)
        - `name` (string, required)
        - `value` (string | number | null, required)
        - `unit` (string | null, required)
      - `clocks` (object[], required)
        - `name` (string, required)
        - `role` (period | event | report | expiration | scheduled | observation, required)
        - `value` (string | null, required)
        - `precision` (instant | date | period | unknown, required)
      - `support` (object, required)
        - `document_id` (string, required)
        - `content_hash` (string, required)
        - `json_pointer` (string<starts_with>, required)
        - `text_span` (object)
          - `start` (integer, required)
          - `end` (integer, required)
    - `sources` (object[], required)
      - `id` (string, required)
      - `source_id` (string<uuid>, required)
      - `kind` (sec_disclosure | government_award | issuer_disclosure | research_input, required)
      - `title` (string, required)
      - `url` (string<uri>, required)
      - `published_at` (string<date-time>, required)
      - `publication_date` (string<date>, required)
      - `publication_precision` (instant | date | unknown, required)
      - `observed_at` (string<date-time>, required)
      - `content_hash` (string, required)
      - `raw_capture_hash` (string, required)
      - `retained_record_hash` (string, required)
      - `capture_basis` (http_response_bytes | retained_export | retained_case, required)
      - `representation` (provider_json | sec_xbrl | visible_text | retained_research_case, required)
    - `admission_contexts` (object[], required)
      - `version` ("company-public-context-v1", required)
      - `context_id` (string<uuid>, required)
      - `content_hash` (string, required)
    - `omitted_records` (integer, required)
    - `conflicting_records` (integer, required)
    - `limitations` (string[], required)
  - `beliefs` (object[], required)
    - `position_lifecycle` (object)
      - `methodology_version` ("position-lifecycle-v1", required)
      - `state` (current | expired | closed | unknown, required)
      - `original_published_at` (string<date-time>, required)
      - `last_confirmed_at` (string<date-time>, required)
      - `expires_at` (string<date-time>, required)
      - `original_evaluation_ends_at` (string<date-time>, required)
      - `renewal_event_id` (string | null, required)
      - `citation_ids` (string[], required)
    - `belief_id` (string, required)
    - `security_id` (null, required)
    - `review_state` ("approved", required)
    - `person` (object, required)
      - `id` (string, required)
      - `name` (string, required)
      - `handle` (string, required)
    - `title` (string, required)
    - `summary` (string, required)
    - `direction` (bullish | bearish | mixed | neutral | non_directional | unknown, required)
    - `status` (forming | active | strengthened | weakened | reversed | resolved | abandoned | unknown, required)
    - `confidence` (object, required)
      - `value` (number, required)
      - `basis` (explicit_confidence | inferred_confidence | not_provided, required)
    - `time_horizon` (string, required)
    - `price_context` (object)
      - `article` (object, required)
        - `title` (string, required)
        - `url` (string, required)
        - `published_at` (string<date-time>, required)
        - `first_observed_at` (string<date-time>, required)
        - `captured_at` (string<date-time>, required)
        - `source_revision_id` (string | null, required)
      - `article_price_context` (object, required)
        - `status` (captured | pending | unavailable, required)
        - `reason` (string | null, required)
        - `reference` (object, required)
          - `price` (number, required)
          - `currency` ("USD", required)
          - `anchor_at` (string<date-time>, required)
          - `quote_at` (string<date-time>, required)
          - `quote_lag_milliseconds` (integer, required)
          - `provider_observed_at` (string<date-time>, required)
          - `provider` (string, required)
          - `feed` (string, required)
          - `scope` (consolidated_nbbo | single_feed_context, required)
          - `adjustment` ("unadjusted_quote", required)
          - `observation_hash` (string, required)
          - `methodology_version` (string, required)
        - `basis` ("quote_midpoint_near_publication_or_effective_date", required)
        - `anchor_basis` (publication | effective_date | unavailable, required)
      - `first_observed_price` (object, required)
        - `status` (captured | pending | unavailable, required)
        - `reason` (string | null, required)
        - `reference` (object, required)
          - `price` (number, required)
          - `currency` ("USD", required)
          - `anchor_at` (string<date-time>, required)
          - `quote_at` (string<date-time>, required)
          - `quote_lag_milliseconds` (integer, required)
          - `provider_observed_at` (string<date-time>, required)
          - `provider` (string, required)
          - `feed` (string, required)
          - `scope` (consolidated_nbbo | single_feed_context, required)
          - `adjustment` ("unadjusted_quote", required)
          - `observation_hash` (string, required)
          - `methodology_version` (string, required)
        - `basis` ("quote_midpoint_near_first_observation", required)
      - `capture_price` (object, required)
        - `status` (captured | pending | unavailable, required)
        - `reason` (string | null, required)
        - `reference` (object, required)
          - `price` (number, required)
          - `currency` ("USD", required)
          - `anchor_at` (string<date-time>, required)
          - `quote_at` (string<date-time>, required)
          - `quote_lag_milliseconds` (integer, required)
          - `provider_observed_at` (string<date-time>, required)
          - `provider` (string, required)
          - `feed` (string, required)
          - `scope` (consolidated_nbbo | single_feed_context, required)
          - `adjustment` ("unadjusted_quote", required)
          - `observation_hash` (string, required)
          - `methodology_version` (string, required)
        - `basis` ("quote_midpoint_near_information_capture", required)
      - `requested_price` (object, required)
        - `status` (current | stale | unverified | unavailable, required)
        - `basis` ("adjusted_daily_close", required)
        - `reference` (object, required)
          - `price` (number, required)
          - `currency` ("USD", required)
          - `session_date` (string<date>, required)
          - `provider_observed_at` (string<date-time>, required)
          - `source` (string, required)
          - `observation_hash` (string, required)
        - `as_of` (string<date-time>, required)
        - `market_session` ("latest_completed_daily_session", required)
    - `first_observed_at` (string<date-time>, required)
    - `effective_at` (string<date-time>, required)
    - `latest_revision_at` (string<date-time>, required)
    - `author_intent` (object)
      - `action` (buy | hold | sell | trim | short | cover | avoid_wait | conditional_buy | directional_opinion | derivative | unknown, required)
      - `basis` (recommendation | self_reported_position | self_reported_trade | third_party_report | published_opinion | unknown, required)
      - `time_context` (current | historical | future_conditional | unspecified, required)
      - `instrument` (equity | option | other | unknown, required)
      - `position_actor` (object)
        - `kind` ("author_personal", required)
        - `name` (null, required)
      - `methodology_version` (belief-author-intent-v1 | belief-author-intent-v2 | belief-author-intent-v3, required)
      - `additional_intents` (object[])
        - `action` (buy | hold | sell | trim | short | cover | avoid_wait | conditional_buy | directional_opinion | derivative | unknown, required)
        - `basis` (recommendation | self_reported_position | self_reported_trade | third_party_report | published_opinion | unknown, required)
        - `time_context` (current | historical | future_conditional | unspecified, required)
        - `instrument` (equity | option | other | unknown, required)
        - `position_actor` (object)
          - `kind` ("author_personal", required)
          - `name` (null, required)
        - `conditions` (object[], required)
          - `statement` (string, required)
          - `citation_ids` (string[], required)
        - `citation_ids` (string[], required)
      - `status` (not_assessed | current | superseded, required)
      - `observation_id` (string | null, required)
      - `observed_at` (string<date-time>, required)
      - `conditions` (object[], required)
        - `statement` (string, required)
        - `citation_ids` (string[], required)
      - `citation_ids` (string[], required)
      - `execution_verified` (false, required)
    - `catalyst_summary` (string, required)
    - `risk_summary` (string, required)
    - `claim_count` (integer, required)
    - `revision_count` (integer, required)
    - `condition_counts` (object, required)
      - `catalyst_total` (integer, required)
      - `catalyst_met` (integer, required)
      - `catalyst_missed` (integer, required)
      - `invalidation_total` (integer, required)
      - `invalidation_triggered` (integer, required)
      - `invalidation_not_triggered` (integer, required)
      - `unknown` (integer, required)
    - `outcome_counts` (object, required)
      - `resolved` (integer, required)
      - `pending` (integer, required)
      - `indeterminate` (integer, required)
    - `market_confirmation` (object, required)
      - `standing` (working | flat | against | unknown, required)
      - `direction_adjusted_excess_percent` (number | null, required)
      - `market_data_through` (string<date>, required)
    - `detail_url` (string<uri>, required)
    - `citation_ids` (string[], required)

### 200 Successful read only response (response variant 9 of 12)

- `billing_notice` (object)
  - `code` ("signup_credit_exhausted", required)
  - `message` (string, required)
  - `remaining_requests` (0, required)
  - `add_credits_url` (string<uri>, required)
  - `plans_url` (string<uri>, required)
- `schema_version` ("1", required)
- `generated_at` (string<date-time>, required)
- `as_of` (string<date-time>, required)
- `resource` ("beliefs", required)
- `data_status` (object, required)
  - `mode` (live | preview, required)
  - `freshness` (current | delayed | stale, required)
  - `coverage` (complete | partial | insufficient, required)
  - `latest_observation_at` (string<date-time>, required)
  - `limitations` (string[], required)
- `methodology_versions` (object, required)
  - `belief_dataset` ("belief-dataset-v11", required)
- `citations` (object[], required)
  - `citation_id` (string, required)
  - `evidence_id` (string, required)
  - `source_url` (string<uri>, required)
  - `source_title` (string, required)
  - `author_name` (string, required)
  - `published_at` (string<date-time>, required)
  - `observed_at` (string<date-time>, required)
  - `excerpt` (string, required)
  - `source_text_coverage` (string) Stored source-capture scope. Null or absent means unknown; no value here verifies complete article coverage.
  - `full_document_stored` (boolean | null) Recorded storage flag, separate from verified source completeness. Null or absent means unknown.
  - `source_type` (string, required)
  - `source_provider` (string, required)
  - `source_revision_id` (string, required)
  - `source_content_hash` (string, required)
  - `review_state` (machine_validated | human_reviewed | creator_corrected, required)
- `warnings` (string[], required)
- `data` (object, required)
  - `passage_support` (object)
    - `status` (available | withheld | unavailable, required)
    - `paragraph_index` (integer, required)
    - `support_index` (integer, required)
    - `support_count` (integer, required)
    - `next_support_index` (integer, required)
    - `citation_id` (string | null, required)
    - `evidence_id` (string | null, required)
    - `source_revision_id` (string | null, required)
    - `source_content_hash` (string | null, required)
    - `start_utf16` (integer, required)
    - `end_utf16` (integer, required)
    - `text` (string | null, required)
    - `text_offset` (integer, required)
    - `next_text_offset` (integer, required)
    - `context_before` (string | null, required)
    - `context_after` (string | null, required)
  - `context_assessments` (object[])
    - `version` ("evidence-case-context-v1", required)
    - `assessment_id` (string<uuid>, required)
    - `supersedes_assessment_id` (string<uuid>, required)
    - `evidence_id` (string<uuid>, required)
    - `source_revision_id` (string<uuid>, required)
    - `source_content_hash` (string, required)
    - `cutoff` (string<date-time>, required)
    - `assessed_at` (string<date-time>, required)
    - `available_at` (string<date-time>, required)
    - `material_context_gaps` (object, required)
      - `reference_collection` (observed | unknown | not_applicable, required)
      - `unavailable_references` (string[], required)
    - `subjects` (object[], required)
      - `security_id` (string<uuid>, required)
      - `ticker` (string, required)
      - `support` (object[], required)
        - `evidence_id` (string<uuid>, required)
        - `start` (integer, required)
        - `end` (integer, required)
        - `visual_asset_id` (string<uuid>, required)
    - `linked_belief_ids` (string<uuid>[], required)
    - `assessment` (object, required)
      - `summary` (string, required)
      - `source_assertions` (object[], required)
        - `statement` (string, required)
        - `support` (object[], required)
          - `evidence_id` (string<uuid>, required)
          - `start` (integer, required)
          - `end` (integer, required)
          - `visual_asset_id` (string<uuid>, required)
        - `measurement` (object, required)
          - `metric` (string, required)
          - `value` (string | null, required)
          - `unit` (string | null, required)
          - `scale` (string | null, required)
          - `period` (string | null, required)
          - `instrument` (object, required)
            - `kind` (equity | bond | cds | other | unknown, required)
            - `identifier` (string | null, required)
            - `issuer_security_id` (string<uuid>, required)
      - `independently_checked_inputs` (object[], required)
        - `statement` (string, required)
        - `checking_input_indexes` (integer[], required)
      - `case_relationships` (object[], required)
        - `belief_id` (string<uuid>, required)
        - `relation` (supports | contradicts | unresolved | unrelated, required)
        - `explanation` (string, required)
        - `case_paragraph_indexes` (integer[], required)
        - `support` (object[], required)
          - `evidence_id` (string<uuid>, required)
          - `start` (integer, required)
          - `end` (integer, required)
          - `visual_asset_id` (string<uuid>, required)
        - `conditions` (string[], required)
        - `unknowns` (string[], required)
      - `stock_price_mechanism` (object, required)
        - `explanation` (string, required)
        - `support` (object[], required)
          - `evidence_id` (string<uuid>, required)
          - `start` (integer, required)
          - `end` (integer, required)
          - `visual_asset_id` (string<uuid>, required)
        - `checking_input_indexes` (integer[], required)
        - `conditions` (string[], required)
        - `unknowns` (string[], required)
      - `unknowns` (string[], required)
    - `checking_inputs` (object[], required)
      - `kind` ("provider_result", required)
      - `schema_version` ("condition-market-support-v1", required)
      - `result_id` (string, required)
      - `provider` ("alpaca", required)
      - `source_type` ("market_price_snapshot", required)
      - `source_content_hash` (string, required)
      - `facts` (object, required)
        - `ticker` (string, required)
        - `price` (number, required)
        - `market_data_at` (string<date-time>, required)
        - `provider_observed_at` (string<date-time>, required)
        - `feed` (string, required)
    - `dependency_keys` (string[], required)
    - `case_snapshot_hash` (string, required)
    - `retrieval` (object, required)
      - `candidate_count` (integer, required)
      - `case_ids` (string<uuid>[], required)
      - `bounded` (boolean, required)
      - `scope` (string, required)
    - `support` (object[], required)
      - `source_id` (string<uuid>, required)
      - `evidence_id` (string<uuid>, required)
      - `source_revision_id` (string<uuid>, required)
      - `attributed_identity_id` (string<uuid>, required)
      - `source_content_hash` (string, required)
      - `source_url` (string<uri>, required)
      - `published_at` (string<date-time>, required)
      - `revision_published_at` (string<date-time>)
      - `first_observed_at` (string<date-time>, required)
      - `captured_at` (string<date-time>, required)
      - `available_at` (string<date-time>, required)
      - `representation` (source_text | visual_transcription, required)
      - `visual_asset_id` (string<uuid>, required)
      - `quote` (string, required)
      - `start` (integer, required)
      - `end` (integer, required)
      - `literal_text` (allowed | withheld, required)
    - `citation_ids` (string[], required)
  - `security` (null, required)
  - `entity` (object, required)
    - `entity_id` (string<uuid>, required)
    - `kind` (company | instrument | commodity | macro_variable | industry | sector | theme | country | geography | person | policy | event_series | event_occurrence | currency | index, required)
    - `namespace` (string, required)
    - `canonical_key` (string, required)
    - `name` (string, required)
    - `security_id` (string<uuid>, required)
    - `parent_entity_id` (string<uuid>, required)
    - `recorded_at` (string<date-time>, required)
    - `available_at` (string<date-time>, required)
    - `release_effective_at` (string<date-time>, required)
    - `aliases` (object[], required)
      - `alias` (string, required)
      - `assertion_id` (string<uuid>, required)
      - `evidence_id` (string, required)
      - `confidence` (number, required)
      - `available_at` (string<date-time>, required)
      - `citation_ids` (string[], required)
  - `capabilities` (object, required)
    - `market_price` (object, required)
      - `available` (false, required)
      - `reason` (string, required)
    - `benchmark_return` (object, required)
      - `available` (false, required)
      - `reason` (string, required)
  - `research_enrichment` (object)
    - `version` ("retained-subject-enrichment-v1", required)
    - `entity_id` (string<uuid>, required)
    - `relevance_basis` ("market_backdrop", required)
    - `subject_exposure` ("not_established", required)
    - `snapshot_captured_at` (string<date-time>, required)
    - `available_at` (string<date-time>, required)
    - `records` (object[], required)
      - `record_id` (string, required)
      - `kind` (string, required)
      - `dimensions` (object, required)
      - `measures` (object[], required)
        - `name` (string, required)
        - `value` (string | number | null, required)
        - `unit` (string | null, required)
      - `clocks` (object[], required)
        - `name` (string, required)
        - `role` (period | event | report | expiration | scheduled | observation, required)
        - `value` (string | null, required)
        - `precision` (instant | date | period | unknown, required)
      - `support` (object, required)
        - `document_id` (string, required)
        - `content_hash` (string, required)
        - `json_pointer` (string<starts_with>, required)
        - `text_span` (object)
          - `start` (integer, required)
          - `end` (integer, required)
    - `sources` (object[], required)
      - `id` (string, required)
      - `source_id` (string<uuid>, required)
      - `kind` (sec_disclosure | government_award | issuer_disclosure | research_input, required)
      - `title` (string, required)
      - `url` (string<uri>, required)
      - `published_at` (string<date-time>, required)
      - `publication_date` (string<date>, required)
      - `publication_precision` (instant | date | unknown, required)
      - `observed_at` (string<date-time>, required)
      - `content_hash` (string, required)
      - `raw_capture_hash` (string, required)
      - `retained_record_hash` (string, required)
      - `capture_basis` (http_response_bytes | retained_export | retained_case, required)
      - `representation` (provider_json | sec_xbrl | visible_text | retained_research_case, required)
    - `admission_contexts` (object[], required)
      - `version` ("company-public-context-v1", required)
      - `context_id` (string<uuid>, required)
      - `content_hash` (string, required)
    - `omitted_records` (integer, required)
    - `conflicting_records` (integer, required)
    - `limitations` (string[], required)
  - `belief` (object, required)
    - `position_lifecycle` (object)
      - `methodology_version` ("position-lifecycle-v1", required)
      - `state` (current | expired | closed | unknown, required)
      - `original_published_at` (string<date-time>, required)
      - `last_confirmed_at` (string<date-time>, required)
      - `expires_at` (string<date-time>, required)
      - `original_evaluation_ends_at` (string<date-time>, required)
      - `renewal_event_id` (string | null, required)
      - `citation_ids` (string[], required)
    - `author_intent` (object)
      - `action` (buy | hold | sell | trim | short | cover | avoid_wait | conditional_buy | directional_opinion | derivative | unknown, required)
      - `basis` (recommendation | self_reported_position | self_reported_trade | third_party_report | published_opinion | unknown, required)
      - `time_context` (current | historical | future_conditional | unspecified, required)
      - `instrument` (equity | option | other | unknown, required)
      - `position_actor` (object)
        - `kind` ("author_personal", required)
        - `name` (null, required)
      - `methodology_version` (belief-author-intent-v1 | belief-author-intent-v2 | belief-author-intent-v3, required)
      - `additional_intents` (object[])
        - `action` (buy | hold | sell | trim | short | cover | avoid_wait | conditional_buy | directional_opinion | derivative | unknown, required)
        - `basis` (recommendation | self_reported_position | self_reported_trade | third_party_report | published_opinion | unknown, required)
        - `time_context` (current | historical | future_conditional | unspecified, required)
        - `instrument` (equity | option | other | unknown, required)
        - `position_actor` (object)
          - `kind` ("author_personal", required)
          - `name` (null, required)
        - `conditions` (object[], required)
          - `statement` (string, required)
          - `citation_ids` (string[], required)
        - `citation_ids` (string[], required)
      - `status` (not_assessed | current | superseded, required)
      - `observation_id` (string | null, required)
      - `observed_at` (string<date-time>, required)
      - `conditions` (object[], required)
        - `statement` (string, required)
        - `citation_ids` (string[], required)
      - `citation_ids` (string[], required)
      - `execution_verified` (false, required)
    - `belief_id` (string, required)
    - `security_id` (null, required)
    - `review_state` ("approved", required)
    - `person` (object, required)
      - `id` (string, required)
      - `name` (string, required)
      - `handle` (string, required)
    - `title` (string, required)
    - `summary` (string, required)
    - `direction` (bullish | bearish | mixed | neutral | non_directional | unknown, required)
    - `investment_case` (object)
      - `schema_version` ("investment-case-v1", required)
      - `relationships` (object[])
        - `schema_version` ("belief-relationship-v1", required)
        - `kind` (supports | contradicts | depends_on | exposure | causal_mechanism, required)
        - `from_entity_id` (string<uuid>, required)
        - `to_entity_id` (string<uuid>, required)
        - `statement` (string, required)
        - `derivation` (source_explicit | source_implied | engine_inferred, required) source_explicit is directly stated; source_implied follows the source argument; engine_inferred is BeliefState's inference and must never become the author's view.
        - `relevant_period` (string, required)
        - `uncertainty` (string, required)
        - `available_at` (string<date-time>, required) Availability of the returned case and endpoint support at the requested cutoff.
        - `citation_ids` (string[], required) Originating source Evidence supporting this relationship statement.
        - `identity_citation_ids` (string[], required) Endpoint identity support; these citations do not independently establish the relationship statement.
      - `source_relationships` (object[])
        - `schema_version` ("source-mention-relationship-v1", required)
        - `relationship_index` (integer, required)
        - `identity_status` ("source_mention_only", required)
        - `from` (object, required)
          - `asset_kind` (company | security | sector | theme | commodity | index | currency | macro_variable | industry | country | geography | person | policy | event_series | event_occurrence | other, required)
          - `source_text` (string, required)
          - `asset_ordinal` (integer, required)
        - `to` (object, required)
          - `asset_kind` (company | security | sector | theme | commodity | index | currency | macro_variable | industry | country | geography | person | policy | event_series | event_occurrence | other, required)
          - `source_text` (string, required)
          - `asset_ordinal` (integer, required)
        - `kind` (supports | contradicts | depends_on | exposure | causal_mechanism, required)
        - `statement` (string, required)
        - `derivation` (source_explicit | source_implied | engine_inferred, required)
        - `relevant_period` (string, required)
        - `uncertainty` (string, required)
        - `available_at` (string<date-time>, required)
        - `citation_ids` (string[], required)
      - `relationship_paths` (object)
        - `scope` ("originating_case", required)
        - `coverage` (unknown | within_case | incomplete, required)
        - `max_depth` (integer, required)
        - `edge_budget` (integer, required)
        - `truncated` (boolean, required) True when the requested edge-step budget prevents completing traversal within the requested depth.
        - `paths` (object[], required)
          - `edge_indexes` (integer[], required) Ordered indexes into this investment_case.relationships list. Every intermediate edge remains present with its separate source/identity citations and derivation.
          - `derivation` ("engine_inferred", required) The sequence is BeliefState's composition, never a source-authored causal conclusion. Individual edge derivation remains unchanged.
          - `available_at` (string<date-time>, required)
        - `limitations` (string[], required)
        - `methodology_version` ("case-relationship-traversal-v1", required)
      - `relationship_coverage` (unknown | direct_links_collected | incomplete) Bounded direct links within this originating case. Absent or unknown means collection is unknown; incomplete means some support or endpoints are unavailable. No multi-hop completeness, causal magnitude or portfolio weights are claimed.
      - `paragraphs` (object[], required)
        - `text` (string, required)
        - `citation_ids` (string[], required)
        - `paragraph_index` (integer)
        - `support_count` (integer)
        - `support_status` (verified | partial | unavailable)
    - `status` (forming | active | strengthened | weakened | reversed | resolved | abandoned | unknown, required)
    - `confidence` (object, required)
      - `value` (number, required)
      - `basis` (explicit_confidence | inferred_confidence | not_provided, required)
    - `time_horizon` (string, required)
    - `price_context` (object)
      - `article` (object, required)
        - `title` (string, required)
        - `url` (string, required)
        - `published_at` (string<date-time>, required)
        - `first_observed_at` (string<date-time>, required)
        - `captured_at` (string<date-time>, required)
        - `source_revision_id` (string | null, required)
      - `article_price_context` (object, required)
        - `status` (captured | pending | unavailable, required)
        - `reason` (string | null, required)
        - `reference` (object, required)
          - `price` (number, required)
          - `currency` ("USD", required)
          - `anchor_at` (string<date-time>, required)
          - `quote_at` (string<date-time>, required)
          - `quote_lag_milliseconds` (integer, required)
          - `provider_observed_at` (string<date-time>, required)
          - `provider` (string, required)
          - `feed` (string, required)
          - `scope` (consolidated_nbbo | single_feed_context, required)
          - `adjustment` ("unadjusted_quote", required)
          - `observation_hash` (string, required)
          - `methodology_version` (string, required)
        - `basis` ("quote_midpoint_near_publication_or_effective_date", required)
        - `anchor_basis` (publication | effective_date | unavailable, required)
      - `first_observed_price` (object, required)
        - `status` (captured | pending | unavailable, required)
        - `reason` (string | null, required)
        - `reference` (object, required)
          - `price` (number, required)
          - `currency` ("USD", required)
          - `anchor_at` (string<date-time>, required)
          - `quote_at` (string<date-time>, required)
          - `quote_lag_milliseconds` (integer, required)
          - `provider_observed_at` (string<date-time>, required)
          - `provider` (string, required)
          - `feed` (string, required)
          - `scope` (consolidated_nbbo | single_feed_context, required)
          - `adjustment` ("unadjusted_quote", required)
          - `observation_hash` (string, required)
          - `methodology_version` (string, required)
        - `basis` ("quote_midpoint_near_first_observation", required)
      - `capture_price` (object, required)
        - `status` (captured | pending | unavailable, required)
        - `reason` (string | null, required)
        - `reference` (object, required)
          - `price` (number, required)
          - `currency` ("USD", required)
          - `anchor_at` (string<date-time>, required)
          - `quote_at` (string<date-time>, required)
          - `quote_lag_milliseconds` (integer, required)
          - `provider_observed_at` (string<date-time>, required)
          - `provider` (string, required)
          - `feed` (string, required)
          - `scope` (consolidated_nbbo | single_feed_context, required)
          - `adjustment` ("unadjusted_quote", required)
          - `observation_hash` (string, required)
          - `methodology_version` (string, required)
        - `basis` ("quote_midpoint_near_information_capture", required)
      - `requested_price` (object, required)
        - `status` (current | stale | unverified | unavailable, required)
        - `basis` ("adjusted_daily_close", required)
        - `reference` (object, required)
          - `price` (number, required)
          - `currency` ("USD", required)
          - `session_date` (string<date>, required)
          - `provider_observed_at` (string<date-time>, required)
          - `source` (string, required)
          - `observation_hash` (string, required)
        - `as_of` (string<date-time>, required)
        - `market_session` ("latest_completed_daily_session", required)
    - `first_observed_at` (string<date-time>, required)
    - `effective_at` (string<date-time>, required)
    - `latest_revision_at` (string<date-time>, required)
    - `claims` (object[], required)
      - `assessment` (object)
        - `claim_id` (string, required)
        - `claim_type` (string, required)
        - `as_of` (string<date-time>, required)
        - `author_horizon` (string | null, required)
        - `expected_by` (string<date-time>, required)
        - `assessment_kind` (factual | subjective | forecast | unclassified, required)
        - `factual_support` (not_applicable | unverified | supported | partially_supported | contradicted | subjective, required)
        - `forecast_status` (not_applicable | pending | overdue_unverified | horizon_unknown | partially_resolved | resolved, required)
        - `forecast_outcome` (string, required)
        - `research_check_status` (not_reviewed | current | stale | inputs_changed, required)
        - `research_verdict` (string, required)
        - `research_checked_at` (string<date-time>, required)
        - `research_evidence` (object[], required)
          - `document_id` (string, required)
          - `quote` (string, required)
          - `source_url` (string<uri>, required)
          - `published_at` (string<date-time>, required)
          - `publication_time_basis` ("filing_date_or_observation_bound", required)
          - `content_hash` (string, required)
          - `start` (integer, required)
          - `end` (integer, required)
        - `condition_results` (object[], required)
          - `condition_id` (string, required)
          - `status` (pending | met | missed | not_triggered | triggered | unknown, required)
          - `route` (market_price | financial_statements | sec_filing | company_release | regulatory | news | unknown, required)
          - `checked_at` (string<date-time>, required)
          - `source_url` (string<uri>, required)
          - `source_published_at` (string<date-time>, required)
          - `expected_by` (string<date-time>, required)
          - `counts_as_resolution` (boolean, required)
        - `limitations` (string[], required)
      - `claim_id` (string, required)
      - `review_state` ("approved", required)
      - `type` (fact | estimate | causal_inference | forecast | opinion | catalyst | risk | invalidation | valuation | target | position_statement | other, required)
      - `statement` (string, required)
      - `subject` (string, required)
      - `predicate` (string, required)
      - `object` (string, required)
      - `value` (string, required)
      - `unit` (string, required)
      - `currency` (string, required)
      - `qualifiers` (object)
      - `time_horizon` (string, required)
      - `confidence` (object, required)
        - `value` (number, required)
        - `basis` (explicit_confidence | inferred_confidence | not_provided, required)
      - `citation_ids` (string[], required)
    - `revisions` (object[], required)
      - `revision_id` (string, required)
      - `type` (expanded | conviction_increased | catalyst_changed | risk_appeared | conviction_reduced | reversed | closed, required)
      - `title` (string, required)
      - `summary` (string, required)
      - `effective_at` (string<date-time>, required)
      - `direction_after` (bullish | bearish | mixed | neutral | non_directional | unknown, required)
      - `confidence_after` (number, required)
      - `confidence_changed` (boolean, required)
      - `terminal_reason` (string, required)
      - `citation_ids` (string[], required)
    - `condition_states` (object[], required)
      - `assessment` (object) Qualification at this read cutoff, separate from the unchanged recorded status. Provider capability describes supported inputs, not enabled monitoring. A current check does not validate the whole investment case.
        - `state` (not_checked | checked_unknown | unqualified | superseded | stale | current | historically_resolved, required)
        - `usable_as_current` (boolean, required)
        - `assessed_at` (string<date-time>, required)
        - `provider_capability` (share_price | sec_issuer | unsupported, required)
        - `reason` (string, required)
        - `methodology_version` ("condition-read-qualification-v1", required)
      - `checking_support` (object)
        - `lineage` ("retained_provider_result", required)
        - `result` (object, required)
          - `kind` ("provider_result", required)
          - `schema_version` ("condition-market-support-v1", required)
          - `result_id` (string, required)
          - `provider` ("alpaca", required)
          - `source_type` ("market_price_snapshot", required)
          - `source_content_hash` (string, required)
          - `facts` (object, required)
            - `ticker` (string, required)
            - `price` (number, required)
            - `market_data_at` (string<date-time>, required)
            - `provider_observed_at` (string<date-time>, required)
            - `feed` (string, required)
      - `condition_match` (object)
        - `schema_version` ("condition-match-v1", required)
        - `condition_id` (string<uuid>, required)
        - `condition_key` (string, required)
        - `status` (pending | met | missed | not_triggered | triggered | unknown, required)
        - `support_hash` (string, required)
        - `dimensions` (object, required)
          - `proposition` (object, required)
            - `assessment` (matched | mismatched | unknown | not_applicable, required)
            - `rationale` (string, required)
          - `entity` (object, required)
            - `assessment` (matched | mismatched | unknown | not_applicable, required)
            - `rationale` (string, required)
          - `reporting_period` (object, required)
            - `assessment` (matched | mismatched | unknown | not_applicable, required)
            - `rationale` (string, required)
          - `unit` (object, required)
            - `assessment` (matched | mismatched | unknown | not_applicable, required)
            - `rationale` (string, required)
          - `consequence` (object, required)
            - `assessment` (matched | mismatched | unknown | not_applicable, required)
            - `rationale` (string, required)
      - `historical_resolution` (object)
        - `resolved_on` (string<date>, required)
        - `rationale` (string, required)
        - `schema_version` ("condition-historical-resolution-v1", required)
        - `condition_id` (string<uuid>, required)
        - `condition_key` (string, required)
        - `status` (met | missed, required)
        - `support_hash` (string, required)
      - `condition_id` (string, required)
      - `originating_evidence_id` (string, required)
      - `originating_claim_id` (string, required)
      - `kind` (catalyst | invalidation, required)
      - `statement` (string, required)
      - `observation_plan` (object, required)
        - `monitoring_plan_review` (object)
          - `recorded_at` (string<date-time>, required)
          - `reason` (string, required)
        - `classification_status` (valid | unrouted | legacy_invalid, required)
        - `route` (market_price | financial_statements | sec_filing | company_release | regulatory | news | unknown, required)
        - `evaluation_mode` (numeric | event | deadline | unknown, required)
        - `metric` (string, required)
        - `operator` (string, required)
        - `target_value` (number | null, required)
        - `target_text` (string, required)
        - `unit` (string, required)
        - `compiler` (object, required)
          - `method` (string, required)
          - `model_version` (string, required)
          - `prompt_version` (string, required)
          - `schema_version` (string, required)
      - `status` (pending | met | missed | not_triggered | triggered | unknown, required)
      - `expected_by` (string<date-time>, required)
      - `observed_value` (number | null, required)
      - `observed_text` (string, required)
      - `explanation` (string, required)
      - `confidence` (number, required)
      - `last_checked_at` (string<date-time>, required)
      - `last_successful_inspection_at` (string<date-time>)
      - `source` (object, required)
        - `provider` (string, required)
        - `url` (string<uri>, required)
        - `title` (string, required)
        - `published_at` (string<date-time>, required)
    - `outcomes` (object[], required)
      - `performance_assessment` (object)
        - `measurement_status` (measured | pending | unavailable, required)
        - `evaluation_status` (evaluated | pending | not_eligible, required)
        - `baseline_method` (string, required)
        - `interpretation` (object, required)
          - `action` (buy | hold | sell | trim | short | cover | avoid_wait | conditional_buy | directional_opinion | derivative | unknown, required)
          - `basis` (recommendation | self_reported_position | self_reported_trade | third_party_report | published_opinion | unknown, required)
          - `timeContext` (current | historical | future_conditional | unspecified, required)
          - `instrument` (equity | option | other | unknown, required)
          - `comparison` (hypothetical_long | hypothetical_short | hypothetical_cash_avoidance | stock_price_context, required)
          - `reason` (string, required)
          - `actualProfitVerified` (false, required)
          - `thesisResolution` ("not_evaluated", required)
          - `priceReturnResolvesThesis` (false, required)
          - `dividendsAndCostsIncluded` (false, required)
          - `cashYieldIncluded` (false, required)
          - `avoidedLossPercent` (number | null, required)
          - `cashVsBenchmarkPercent` (number | null, required)
        - `measures` ("hypothetical_publication_based_price_performance", required)
        - `verifies_claim_truth` (false, required)
        - `verifies_author_profit` (false, required)
      - `anchor_type` (initial_belief | revision, required)
      - `revision_id` (string, required)
      - `horizon_sessions` (number, required)
      - `horizon_unit` ("completed_us_trading_sessions", required)
      - `status` (resolved | pending | indeterminate, required)
      - `label` (correct | incorrect | mixed | unknown, required)
      - `hit` (boolean | null, required)
      - `confidence_snapshot` (number, required)
      - `baseline_at` (string<date-time>, required)
      - `outcome_at` (string<date-time>, required)
      - `security_return_percent` (number | null, required)
      - `benchmark_return_percent` (number | null, required)
      - `direction_adjusted_excess_percent` (number | null, required)
      - `maximum_favorable_excursion_percent` (number | null, required)
      - `maximum_adverse_excursion_percent` (number | null, required)
      - `time_profitable_percent` (number, required)
      - `path_efficiency_percent` (number, required)
      - `volatility_adjusted_return` (number | null, required)
      - `benchmark_ticker` ("SPY", required)
      - `price_source` (string, required)
      - `market_data_through` (string<date>, required)
      - `observed_at` (string<date-time>, required)
      - `methodology_version` (string, required)
    - `since_inception` (object, required)
      - `performance_assessment` (object)
        - `measurement_status` (measured | pending | unavailable, required)
        - `evaluation_status` (evaluated | pending | not_eligible, required)
        - `baseline_method` (string, required)
        - `interpretation` (object, required)
          - `action` (buy | hold | sell | trim | short | cover | avoid_wait | conditional_buy | directional_opinion | derivative | unknown, required)
          - `basis` (recommendation | self_reported_position | self_reported_trade | third_party_report | published_opinion | unknown, required)
          - `timeContext` (current | historical | future_conditional | unspecified, required)
          - `instrument` (equity | option | other | unknown, required)
          - `comparison` (hypothetical_long | hypothetical_short | hypothetical_cash_avoidance | stock_price_context, required)
          - `reason` (string, required)
          - `actualProfitVerified` (false, required)
          - `thesisResolution` ("not_evaluated", required)
          - `priceReturnResolvesThesis` (false, required)
          - `dividendsAndCostsIncluded` (false, required)
          - `cashYieldIncluded` (false, required)
          - `avoidedLossPercent` (number | null, required)
          - `cashVsBenchmarkPercent` (number | null, required)
        - `measures` ("hypothetical_publication_based_price_performance", required)
        - `verifies_claim_truth` (false, required)
        - `verifies_author_profit` (false, required)
      - `anchor_type` (initial_belief | revision, required)
      - `revision_id` (string, required)
      - `status` (measured | pending | indeterminate, required)
      - `standing` (working | flat | against | unknown, required)
      - `completed_sessions` (integer, required)
      - `baseline_at` (string<date-time>, required)
      - `current_at` (string<date-time>, required)
      - `baseline_price` (number, required)
      - `current_price` (number, required)
      - `security_return_percent` (number | null, required)
      - `benchmark_return_percent` (number | null, required)
      - `direction_adjusted_return_percent` (number | null, required)
      - `direction_adjusted_excess_percent` (number | null, required)
      - `maximum_favorable_excursion_percent` (number | null, required)
      - `maximum_adverse_excursion_percent` (number | null, required)
      - `time_profitable_percent` (number, required)
      - `path_efficiency_percent` (number, required)
      - `volatility_adjusted_return` (number | null, required)
      - `benchmark_ticker` ("SPY", required)
      - `price_source` (string, required)
      - `market_data_through` (string<date>, required)
      - `observed_at` (string<date-time>, required)
      - `methodology_version` (string, required)
    - `provenance` (object, required)
      - `thesis_cluster_id` (string, required)
      - `model_version` (string, required)
      - `prompt_version` (string, required)
      - `lineage_role` (originator | specialist_adoption | generalist_adoption | unknown, required)
      - `independent_source_count` (integer, required)
    - `citation_ids` (string[], required)
  - `decision_review` (object, required)
    - `status` (not_reviewed | current | stale | inputs_changed, required)
    - `conclusion` (string, required)
    - `research_check` (object, required)
      - `checked_at` (string<date-time>, required)
      - `evidence_observed_at` (string<date-time>, required)
      - `issuer_context_hash` (string, required)
      - `thesis_input_hash` (string, required)
      - `model` (string, required)
      - `decision_assessment` (object, required)
        - `usefulness` (insufficient_evidence | adds_context | changes_risk_assessment | changes_thesis_assessment, required)
        - `conclusion` (string, required)
        - `next_checks` (string[], required)
      - `material_context` (object[], required)
        - `statement` (string, required)
        - `relevance` (string, required)
        - `evidence` (object[], required)
          - `document_id` (string, required)
          - `quote` (string, required)
          - `source_url` (string<uri>, required)
          - `published_at` (string<date-time>, required)
          - `publication_time_basis` ("filing_date_or_observation_bound", required)
          - `content_hash` (string, required)
          - `start` (integer, required)
          - `end` (integer, required)
      - `checks` (object[], required)
        - `claim_id` (string, required)
        - `verdict` (supported | partially_supported | contradicted | not_yet_testable | subjective | unverified, required)
        - `explanation` (string, required)
        - `evidence` (object[], required)
          - `document_id` (string, required)
          - `quote` (string, required)
          - `source_url` (string<uri>, required)
          - `published_at` (string<date-time>, required)
          - `publication_time_basis` ("filing_date_or_observation_bound", required)
          - `content_hash` (string, required)
          - `start` (integer, required)
          - `end` (integer, required)
        - `statement` (string, required)
      - `selected_claim_count` (integer, required)
      - `total_claim_count` (integer, required)
      - `missing_information` (string[], required)
      - `author_followup` (object, required)
        - `status` (newer_material_found | no_newer_items_in_feed_window | not_verified | fetch_failed, required)
        - `checked_at` (string<date-time>, required)
        - `feed_url` (string<uri>, required)
        - `window_start` (string<date-time>, required)
        - `window_end` (string<date-time>, required)
        - `newer_items` (object[], required)
          - `title` (string, required)
          - `url` (string<uri>, required)
          - `published_at` (string<date-time>, required)
        - `scope` ("public_feed_metadata_only", required)
        - `limitation` (string, required)
      - `methodology_version` ("thesis-research-check-v4", required)
  - `visuals` (object)
    - `descriptors` (object[], required)
      - `visual_id` (string, required)
      - `evidence_id` (string, required)
      - `source_id` (string<uuid>, required)
      - `source_revision_id` (string<uuid>, required)
      - `source_content_hash` (string, required)
      - `citation_id` (string, required)
      - `representation` (image | native_table, required)
      - `image_type` (table | chart | text | illustration | mixed | unknown, required)
      - `materiality` (material | non_material | unknown, required)
      - `schema_version` (string | null, required)
      - `available_at` (string<date-time>, required)
      - `availability` (available | after_cutoff | missing | incompatible | legacy_unknown, required)
      - `literal_text` (allowed | withheld, required)
      - `next_region_offset` (integer, required)
      - `regions` (object[], required)
        - `region_id` (string, required)
        - `kind` (text | table | chart, required)
        - `rows` (integer, required)
        - `columns` (integer, required)
    - `next_visual_offset` (integer, required)
    - `selected_region` (object, required)
      - `visual_id` (string, required)
      - `region_id` (string, required)
      - `kind` (text | table | chart, required)
      - `text` (string | null, required)
      - `geometry` (object, required)
        - `coordinate_system` ("normalized-top-left", required)
        - `width` (number, required)
        - `height` (number, required)
      - `row_offset` (integer, required)
      - `row_limit` (integer, required)
      - `total_rows` (integer, required)
      - `has_more` (boolean, required)
      - `cells` (object[], required)
        - `cell_id` (string, required)
        - `row` (integer, required)
        - `column` (integer, required)
        - `text` (string | null, required)
        - `bounds` (number[], required)
        - `row_span` (integer, required)
        - `column_span` (integer, required)
        - `status` (value | blank | unreadable | not_applicable | unknown | legacy_unknown, required)
        - `role` (header | data | footnote | unknown, required)
        - `header_ids` (string[], required)
        - `footnote_ids` (string[], required)
        - `value` (object, required)
          - `decimal` (string, required)
          - `unit` (string | null, required)
          - `currency` (string | null, required)
          - `scale` (string, required)
          - `period` (string | null, required)
          - `scenario` (string | null, required)
          - `support` (literal | derived | estimated | unknown, required)
      - `footnotes` (object[], required)
        - `id` (string, required)
        - `text` (string | null, required)
      - `chart` (object, required)
        - `coverage` (printed_values_only | partial | unreadable | unknown, required)
        - `axes` (object[], required)
          - `label` (string | null, required)
          - `unit` (string | null, required)
        - `series` (object[], required)
          - `label` (string | null, required)
          - `points` (object[], required)
            - `label` (string | null, required)
            - `text` (string | null, required)
            - `value` (object, required)
              - `decimal` (string, required)
              - `unit` (string | null, required)
              - `currency` (string | null, required)
              - `scale` (string, required)
              - `period` (string | null, required)
              - `scenario` (string | null, required)
              - `support` (literal | derived | estimated | unknown, required)
    - `coverage` (available | partial | no_saved_visual_data, required)

### 200 Successful read only response (response variant 10 of 12)

- `billing_notice` (object)
  - `code` ("signup_credit_exhausted", required)
  - `message` (string, required)
  - `remaining_requests` (0, required)
  - `add_credits_url` (string<uri>, required)
  - `plans_url` (string<uri>, required)
- `schema_version` ("1", required)
- `generated_at` (string<date-time>, required)
- `as_of` (string<date-time>, required)
- `resource` ("beliefs", required)
- `data_status` (object, required)
  - `mode` (live | preview, required)
  - `freshness` (current | delayed | stale, required)
  - `coverage` (complete | partial | insufficient, required)
  - `latest_observation_at` (string<date-time>, required)
  - `limitations` (string[], required)
- `methodology_versions` (object, required)
  - `belief_dataset` ("belief-dataset-v11", required)
- `citations` (object[], required)
  - `citation_id` (string, required)
  - `evidence_id` (string, required)
  - `source_url` (string<uri>, required)
  - `source_title` (string, required)
  - `author_name` (string, required)
  - `published_at` (string<date-time>, required)
  - `observed_at` (string<date-time>, required)
  - `excerpt` (string, required)
  - `source_text_coverage` (string) Stored source-capture scope. Null or absent means unknown; no value here verifies complete article coverage.
  - `full_document_stored` (boolean | null) Recorded storage flag, separate from verified source completeness. Null or absent means unknown.
  - `source_type` (string, required)
  - `source_provider` (string, required)
  - `source_revision_id` (string, required)
  - `source_content_hash` (string, required)
  - `review_state` (machine_validated | human_reviewed | creator_corrected, required)
- `warnings` (string[], required)
- `pagination` (object, required)
  - `limit` (integer, required)
  - `returned` (integer, required)
  - `total_available` (integer, required)
  - `total_observed_at` (string<date-time>)
  - `has_more` (boolean, required)
  - `next_cursor` (string | null, required)
  - `next_page_url` (string<uri>, required)
- `data` (object, required)
  - `view` ("entities", required)
  - `entities` (object[], required)
    - `entity_id` (string<uuid>, required)
    - `kind` (company | instrument | commodity | macro_variable | industry | sector | theme | country | geography | person | policy | event_series | event_occurrence | currency | index, required)
    - `namespace` (string, required)
    - `canonical_key` (string, required)
    - `name` (string, required)
    - `security_id` (string<uuid>, required)
    - `parent_entity_id` (string<uuid>, required)
    - `recorded_at` (string<date-time>, required)
    - `available_at` (string<date-time>, required)
    - `release_effective_at` (string<date-time>, required)
    - `aliases` (object[], required)
      - `alias` (string, required)
      - `assertion_id` (string<uuid>, required)
      - `evidence_id` (string, required)
      - `confidence` (number, required)
      - `available_at` (string<date-time>, required)
      - `citation_ids` (string[], required)

### 200 Successful read only response (response variant 11 of 12)

- `billing_notice` (object)
  - `code` ("signup_credit_exhausted", required)
  - `message` (string, required)
  - `remaining_requests` (0, required)
  - `add_credits_url` (string<uri>, required)
  - `plans_url` (string<uri>, required)
- `schema_version` ("1", required)
- `generated_at` (string<date-time>, required)
- `as_of` (string<date-time>, required)
- `resource` ("beliefs", required)
- `data_status` (object, required)
  - `mode` (live | preview, required)
  - `freshness` (current | delayed | stale, required)
  - `coverage` (complete | partial | insufficient, required)
  - `latest_observation_at` (string<date-time>, required)
  - `limitations` (string[], required)
- `methodology_versions` (object, required)
  - `belief_dataset` ("belief-dataset-v11", required)
- `citations` (object[], required)
  - `citation_id` (string, required)
  - `evidence_id` (string, required)
  - `source_url` (string<uri>, required)
  - `source_title` (string, required)
  - `author_name` (string, required)
  - `published_at` (string<date-time>, required)
  - `observed_at` (string<date-time>, required)
  - `excerpt` (string, required)
  - `source_text_coverage` (string) Stored source-capture scope. Null or absent means unknown; no value here verifies complete article coverage.
  - `full_document_stored` (boolean | null) Recorded storage flag, separate from verified source completeness. Null or absent means unknown.
  - `source_type` (string, required)
  - `source_provider` (string, required)
  - `source_revision_id` (string, required)
  - `source_content_hash` (string, required)
  - `review_state` (machine_validated | human_reviewed | creator_corrected, required)
- `warnings` (string[], required)
- `pagination` (object, required)
  - `limit` (integer, required)
  - `returned` (integer, required)
  - `total_available` (integer, required)
  - `total_observed_at` (string<date-time>)
  - `has_more` (boolean, required)
  - `next_cursor` (string | null, required)
  - `next_page_url` (string<uri>, required)
- `data` (object, required)
  - `security` (object, required)
    - `id` (string, required)
    - `ticker` (string, required)
    - `name` (string, required)
  - `beliefs` (object[], required)
    - `position_lifecycle` (object)
      - `methodology_version` ("position-lifecycle-v1", required)
      - `state` (current | expired | closed | unknown, required)
      - `original_published_at` (string<date-time>, required)
      - `last_confirmed_at` (string<date-time>, required)
      - `expires_at` (string<date-time>, required)
      - `original_evaluation_ends_at` (string<date-time>, required)
      - `renewal_event_id` (string | null, required)
      - `citation_ids` (string[], required)
    - `belief_id` (string, required)
    - `security_id` (string, required)
    - `review_state` ("approved", required)
    - `person` (object, required)
      - `id` (string, required)
      - `name` (string, required)
      - `handle` (string, required)
    - `title` (string, required)
    - `summary` (string, required)
    - `direction` (bullish | bearish | mixed | neutral | non_directional | unknown, required)
    - `status` (forming | active | strengthened | weakened | reversed | resolved | abandoned | unknown, required)
    - `confidence` (object, required)
      - `value` (number, required)
      - `basis` (explicit_confidence | inferred_confidence | not_provided, required)
    - `time_horizon` (string, required)
    - `price_context` (object)
      - `article` (object, required)
        - `title` (string, required)
        - `url` (string, required)
        - `published_at` (string<date-time>, required)
        - `first_observed_at` (string<date-time>, required)
        - `captured_at` (string<date-time>, required)
        - `source_revision_id` (string | null, required)
      - `article_price_context` (object, required)
        - `status` (captured | pending | unavailable, required)
        - `reason` (string | null, required)
        - `reference` (object, required)
          - `price` (number, required)
          - `currency` ("USD", required)
          - `anchor_at` (string<date-time>, required)
          - `quote_at` (string<date-time>, required)
          - `quote_lag_milliseconds` (integer, required)
          - `provider_observed_at` (string<date-time>, required)
          - `provider` (string, required)
          - `feed` (string, required)
          - `scope` (consolidated_nbbo | single_feed_context, required)
          - `adjustment` ("unadjusted_quote", required)
          - `observation_hash` (string, required)
          - `methodology_version` (string, required)
        - `basis` ("quote_midpoint_near_publication_or_effective_date", required)
        - `anchor_basis` (publication | effective_date | unavailable, required)
      - `first_observed_price` (object, required)
        - `status` (captured | pending | unavailable, required)
        - `reason` (string | null, required)
        - `reference` (object, required)
          - `price` (number, required)
          - `currency` ("USD", required)
          - `anchor_at` (string<date-time>, required)
          - `quote_at` (string<date-time>, required)
          - `quote_lag_milliseconds` (integer, required)
          - `provider_observed_at` (string<date-time>, required)
          - `provider` (string, required)
          - `feed` (string, required)
          - `scope` (consolidated_nbbo | single_feed_context, required)
          - `adjustment` ("unadjusted_quote", required)
          - `observation_hash` (string, required)
          - `methodology_version` (string, required)
        - `basis` ("quote_midpoint_near_first_observation", required)
      - `capture_price` (object, required)
        - `status` (captured | pending | unavailable, required)
        - `reason` (string | null, required)
        - `reference` (object, required)
          - `price` (number, required)
          - `currency` ("USD", required)
          - `anchor_at` (string<date-time>, required)
          - `quote_at` (string<date-time>, required)
          - `quote_lag_milliseconds` (integer, required)
          - `provider_observed_at` (string<date-time>, required)
          - `provider` (string, required)
          - `feed` (string, required)
          - `scope` (consolidated_nbbo | single_feed_context, required)
          - `adjustment` ("unadjusted_quote", required)
          - `observation_hash` (string, required)
          - `methodology_version` (string, required)
        - `basis` ("quote_midpoint_near_information_capture", required)
      - `requested_price` (object, required)
        - `status` (current | stale | unverified | unavailable, required)
        - `basis` ("adjusted_daily_close", required)
        - `reference` (object, required)
          - `price` (number, required)
          - `currency` ("USD", required)
          - `session_date` (string<date>, required)
          - `provider_observed_at` (string<date-time>, required)
          - `source` (string, required)
          - `observation_hash` (string, required)
        - `as_of` (string<date-time>, required)
        - `market_session` ("latest_completed_daily_session", required)
    - `first_observed_at` (string<date-time>, required)
    - `effective_at` (string<date-time>, required)
    - `latest_revision_at` (string<date-time>, required)
    - `author_intent` (object)
      - `action` (buy | hold | sell | trim | short | cover | avoid_wait | conditional_buy | directional_opinion | derivative | unknown, required)
      - `basis` (recommendation | self_reported_position | self_reported_trade | third_party_report | published_opinion | unknown, required)
      - `time_context` (current | historical | future_conditional | unspecified, required)
      - `instrument` (equity | option | other | unknown, required)
      - `position_actor` (object)
        - `kind` ("author_personal", required)
        - `name` (null, required)
      - `methodology_version` (belief-author-intent-v1 | belief-author-intent-v2 | belief-author-intent-v3, required)
      - `additional_intents` (object[])
        - `action` (buy | hold | sell | trim | short | cover | avoid_wait | conditional_buy | directional_opinion | derivative | unknown, required)
        - `basis` (recommendation | self_reported_position | self_reported_trade | third_party_report | published_opinion | unknown, required)
        - `time_context` (current | historical | future_conditional | unspecified, required)
        - `instrument` (equity | option | other | unknown, required)
        - `position_actor` (object)
          - `kind` ("author_personal", required)
          - `name` (null, required)
        - `conditions` (object[], required)
          - `statement` (string, required)
          - `citation_ids` (string[], required)
        - `citation_ids` (string[], required)
      - `status` (not_assessed | current | superseded, required)
      - `observation_id` (string | null, required)
      - `observed_at` (string<date-time>, required)
      - `conditions` (object[], required)
        - `statement` (string, required)
        - `citation_ids` (string[], required)
      - `citation_ids` (string[], required)
      - `execution_verified` (false, required)
    - `catalyst_summary` (string, required)
    - `risk_summary` (string, required)
    - `claim_count` (integer, required)
    - `revision_count` (integer, required)
    - `condition_counts` (object, required)
      - `catalyst_total` (integer, required)
      - `catalyst_met` (integer, required)
      - `catalyst_missed` (integer, required)
      - `invalidation_total` (integer, required)
      - `invalidation_triggered` (integer, required)
      - `invalidation_not_triggered` (integer, required)
      - `unknown` (integer, required)
    - `outcome_counts` (object, required)
      - `resolved` (integer, required)
      - `pending` (integer, required)
      - `indeterminate` (integer, required)
    - `market_confirmation` (object, required)
      - `standing` (working | flat | against | unknown, required)
      - `direction_adjusted_excess_percent` (number | null, required)
      - `market_data_through` (string<date>, required)
    - `detail_url` (string<uri>, required)
    - `citation_ids` (string[], required)
  - `entity` (object, required)
    - `entity_id` (string<uuid>, required)
    - `kind` (company | instrument | commodity | macro_variable | industry | sector | theme | country | geography | person | policy | event_series | event_occurrence | currency | index, required)
    - `namespace` (string, required)
    - `canonical_key` (string, required)
    - `name` (string, required)
    - `security_id` (string<uuid>, required)
    - `parent_entity_id` (string<uuid>, required)
    - `recorded_at` (string<date-time>, required)
    - `available_at` (string<date-time>, required)
    - `release_effective_at` (string<date-time>, required)
    - `aliases` (object[], required)
      - `alias` (string, required)
      - `assertion_id` (string<uuid>, required)
      - `evidence_id` (string, required)
      - `confidence` (number, required)
      - `available_at` (string<date-time>, required)
      - `citation_ids` (string[], required)
  - `capabilities` (object, required)
    - `market_price` (object, required)
      - `available` (boolean, required)
      - `reason` (string, required)
    - `benchmark_return` (object, required)
      - `available` (boolean, required)
      - `reason` (string, required)

### 200 Successful read only response (response variant 12 of 12)

- `billing_notice` (object)
  - `code` ("signup_credit_exhausted", required)
  - `message` (string, required)
  - `remaining_requests` (0, required)
  - `add_credits_url` (string<uri>, required)
  - `plans_url` (string<uri>, required)
- `schema_version` ("1", required)
- `methodology_version` ("belief-changes-v1", required)
- `generated_at` (string<date-time>, required)
- `as_of` (string<date-time>, required)
- `scope` (object, required)
  - `ticker` (string, required)
- `data_status` (object, required)
  - `mode` (live | preview, required)
  - `freshness` (current | delayed | stale, required)
  - `coverage` (complete | partial | insufficient, required)
  - `latest_observation_at` (string<date-time>, required)
  - `limitations` (string[], required)
- `entitlement` (object, required)
  - `freshness` (string, required)
  - `history_start` (string<date-time>, required)
  - `result_limit` (integer, required)
- `data` (object, required)
  - `mode` (changes | resync, required)
  - `status` (available | resync_required | projection_catching_up | history_uninitialized, required)
  - `changes` (object[], required)
    - `event_id` (string<uuid>, required)
    - `kind` (string, required)
    - `belief_id` (string<uuid>, required)
    - `context_assessment_id` (string<uuid>)
    - `entity_id` (string<uuid>, required)
    - `security_id` (string<uuid>, required)
    - `domain` (author_view | author_condition | engine_assessment | calculated_publication_outcome | distribution | identity_resolution | provenance | engine_quality | engine_plan, required)
    - `changed_dimensions` (string[], required)
    - `before` (object, required)
    - `after` (object, required)
    - `clocks` (object, required)
      - `author_published_at` (string<date-time>, required)
      - `effective_at` (string<date-time>, required)
      - `occurrence_at` (string<date-time>, required)
      - `observed_at` (string<date-time>, required)
      - `source_observed_at` (string<date-time>, required)
      - `source_captured_at` (string<date-time>, required)
      - `assessed_at` (string<date-time>, required)
      - `canonical_recorded_at` (string<date-time>, required)
      - `promotion_recorded_at` (string<date-time>, required)
      - `post_commit_observed_at` (string<date-time>, required)
      - `available_at` (string<date-time>, required)
    - `reconstructed` (boolean, required)
    - `methodology` (object, required)
    - `citation_ids` (string[], required)
    - `omitted_fields` (string[], required)
  - `inventory` (object[], required)
    - `belief_id` (string<uuid>, required)
    - `context_assessment_id` (string<uuid>)
    - `entity_id` (string<uuid>, required)
    - `security_id` (string<uuid>, required)
    - `citation_ids` (string[], required)
  - `continuation_cursor` (string | null, required)
  - `polling_checkpoint` (string | null, required)
  - `projection_epoch` (string<uuid>, required)
  - `history_coverage` (object, required)
- `citations` (object[], required)
  - `citation_id` (string, required)
  - `evidence_id` (string, required)
  - `source_url` (string<uri>, required)
  - `source_title` (string, required)
  - `author_name` (string, required)
  - `published_at` (string<date-time>, required)
  - `observed_at` (string<date-time>, required)
  - `excerpt` (string, required)
  - `source_text_coverage` (string) Stored source-capture scope. Null or absent means unknown; no value here verifies complete article coverage.
  - `full_document_stored` (boolean | null) Recorded storage flag, separate from verified source completeness. Null or absent means unknown.
- `warnings` (string[], required)

### 400 Invalid input

- `error` (object, required)
  - `code` (string, required)
  - `message` (string, required)
  - `recovery` (string | null, required)
  - `retryable` (boolean, required)

### 401 Authentication failed

- `error` (object, required)
  - `code` (string, required)
  - `message` (string, required)
  - `recovery` (string | null, required)
  - `retryable` (boolean, required)

### 402 Paid access required

- `error` (object, required)
  - `code` (string, required)
  - `message` (string, required)
  - `recovery` (string | null, required)
  - `retryable` (boolean, required)

### 404 Security unavailable

- `error` (object, required)
  - `code` (string, required)
  - `message` (string, required)
  - `recovery` (string | null, required)
  - `retryable` (boolean, required)

### 409 Duplicate request ID

- `error` (object, required)
  - `code` (string, required)
  - `message` (string, required)
  - `recovery` (string | null, required)
  - `retryable` (boolean, required)

### 503 Stored intelligence temporarily unavailable

- `error` (object, required)
  - `code` (string, required)
  - `message` (string, required)
  - `recovery` (string | null, required)
  - `retryable` (boolean, required)

## Agent feedback

Report unclear, stale, or incorrect documentation through [BeliefState support](https://beliefstate.ai/contact). Include this page URL and the smallest reproducible detail.

<!-- BeliefState-Origin: https://beliefstate.ai/docs/api/beliefs; Content-Fingerprint: bs-sha256-af99d2ed0273e5c5912208f8978ec04ff4b6a29b8b775c0ef201bc4862a4f8b1 -->