get_case

Get investment case · $0.02 per call (x402, USDC) Retrieves one complete investment case by returned belief_id: investor, reasoning, evidence, risks, catalysts, conditions, revisions, outcomes, provenance and coverage gaps. Useful for deeper follow-ups; start company overviews with get_brief. Use paragraph_index only when returned in investment_case and follow support/text offsets for exact evidence. Optional relationship_paths inspects supported dependencies; scenario applies up to eight hypothetical conditions. Both preserve evidence and investor statements.

Input parameters

Parameter	Type	Required	Description
`belief_id`	string	Yes	min length 1; max length 128
`as_of`	string	No
`paragraph_index`	integer	No	Read exact source support only for a paragraph_index present in the returned investment_case. Records without investment_case do not support this selector. Requires belief_id. Continue with returned as_of and support/text offsets. min 0; max 44
`support_index`	integer	No	Source support within the selected paragraph; defaults to 0. Use next_support_index for another passage. min 0; max 9007199254740991
`support_text_offset`	integer	No	UTF-16 offset within the selected supporting passage; defaults to 0. Use next_text_offset to continue its text. min 0; max 9007199254740991
`scenario`	object	No	Optional hypothetical condition assumptions for this belief. Does not change evidence or predict the investor’s response. REST: JSON-encode this query parameter.
`relationship_paths`	object	No	Inspect directed edge sequences within this Belief’s originating case. Maximum depth is 3; edge_budget bounds examined edge steps. Requires belief_id. REST: JSON-encode relationship_paths.

Transports

MCP: tools/call with name get_case at https://beliefstate.ai/mcp (account access) or https://beliefstate.ai/v1/research/mcp (wallet access). See MCP integration.
x402 HTTP: POST https://beliefstate.ai/v1/research/get_case with the arguments as a JSON body. An unpaid request returns an HTTP 402 payment quote.
Related REST resource: GET /v1/beliefs.

Example request

MCP

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_case",
    "arguments": {
      "belief_id": "00000000-0000-4000-8000-000000000001"
    }
  }
}

x402 HTTP

curl --request POST \
  --url 'https://beliefstate.ai/v1/research/get_case' \
  --header 'Content-Type: application/json' \
  --data '{"belief_id":"00000000-0000-4000-8000-000000000001"}'

The example shows request shape only. Identifiers are placeholders, not records.

Contract version: 2026-11-08. Input parameters and tool metadata come from the shared executable catalog. REST API version: v1.

Get Started

Core Concepts

Guides

Reference

Endpoints

Research tools

Input parameters

Transports

Example request

MCP

x402 HTTP

​Input parameters

​Transports

​Example request

​MCP

​x402 HTTP

​Related

Input parameters

Transports

Example request

MCP

x402 HTTP

Related