> ## 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_cases

> Get investment cases

**Get investment cases** · \$0.02 per call (x402, USDC)

Retrieves dated investment cases for one company or research subject, with optional investor, direction and time filters. Returns attributed thesis records, case IDs, dates, citations and coverage information. Useful for building a research inventory or finding additional cases beyond a brief. Use get\_brief for an ordinary overview and get\_search\_results for a thesis or topic question. Continue a requested inventory with unchanged selectors and its returned cursor.

## Input parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `ticker` | string | No | min length 1; max length 32 |
| `entity_id` | string | No | Released subject ID returned by get\_subjects. |
| `person_id` | string | No | min length 1; max length 128 |
| `direction` | "bullish" \| "bearish" \| "mixed" \| "neutral" \| "non\_directional" \| "unknown" | No | |
| `status` | "forming" \| "active" \| "strengthened" \| "weakened" \| "reversed" \| "resolved" \| "abandoned" \| "unknown" | No | |
| `time_horizon` | string | No | min length 1; max length 128 |
| `changed_since` | string | No | Find initial research, author revisions, condition checks/plans or released outcomes becoming available after this cutoff. Keeps author dates and stance separate from system activity. Release changes and a complete ordered event-history checkpoint are not yet included. |
| `as_of` | string | No | |
| `limit` | integer | No | Requested page size. For ticker/entity belief lists, MCP returns up to twelve complete summaries within its response budget; pagination.limit is the effective size. Continue with next\_cursor and the same ticker/entity\_id. REST supports larger pages. min 1; max 50 |
| `cursor` | string | No | min length 1; max length 2048 |

## Transports

* **MCP:** `tools/call` with name `get_cases` 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_cases` 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_cases",
    "arguments": {
      "ticker": "NBIS",
      "limit": 5
    }
  }
}
```

### x402 HTTP

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
curl --request POST \
  --url 'https://beliefstate.ai/v1/research/get_cases' \
  --header 'Content-Type: application/json' \
  --data '{"ticker":"NBIS","limit":5}'
```

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.