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

> Read research visual

**Read research visual** · \$0.02 per call (x402, USDC)

Read one cited chart or table, including its regions and paginated exact rows or data points.

## Input parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `belief_id` | string | No | min length 1; max length 128 |
| `context_assessment_id` | string | No | Open a neutral engine context assessment returned by a brief or ordered change. It is not an author Belief. |
| `as_of` | string | No | |
| `visual_id` | string | Yes | Saved visual ID returned by list\_research\_visuals. |
| `region_id` | string | No | Use a region\_id returned in the selected visual's regions to retrieve structured data. |
| `region_offset` | integer | No | Continue a selected visual's region descriptors using next\_region\_offset. min 0; max 9007199254740991 |
| `row_offset` | integer | No | Zero-based starting row or chart-point index in the selected region. min 0; max 999 |
| `row_limit` | integer | No | Rows or chart points per read; defaults to 50, maximum 100. min 1; max 100 |

## Transports

* **MCP:** `tools/call` with name `get_research_visual` at `https://beliefstate.ai/mcp` (account access) or the wallet-paid x402 MCP server. See [MCP integration](https://docs.beliefstate.ai/guides/mcp-server.md).
* **x402 HTTP:** `POST https://beliefstate.ai/v1/research/get_research_visual` 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={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_research_visual",
    "arguments": {
      "belief_id": "00000000-0000-4000-8000-000000000001",
      "visual_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    }
  }
}
```

### x402 HTTP

```bash theme={null}
curl --request POST \
  --url 'https://beliefstate.ai/v1/research/get_research_visual' \
  --header 'Content-Type: application/json' \
  --data '{"belief_id":"00000000-0000-4000-8000-000000000001","visual_id":"aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}'
```

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)


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