> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beliefstate.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# get_case

> Get investment 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](https://docs.beliefstate.ai/guides/mcp-server.md).
* **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`](https://docs.beliefstate.ai/api-reference/beliefs/find-investor-beliefs-or-inspect-a-full-record).

## Example request

### MCP

```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_case",
    "arguments": {
      "belief_id": "00000000-0000-4000-8000-000000000001"
    }
  }
}
```

### x402 HTTP

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
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.

## Related

* [All research tools](https://docs.beliefstate.ai/tools/index.md)
* [API reference: GET /v1/beliefs](https://docs.beliefstate.ai/api-reference/beliefs/find-investor-beliefs-or-inspect-a-full-record.md)

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.