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

> Get research changes

**Get research changes** · \$0.02 per call (x402, USDC)

Retrieves the ordered research change journal for a company, subject, case or explicitly selected released corpus. Returns dated events, citations and available before/after values, separating author revisions, distribution changes and calculated publication outcomes. Use domain=author\_view for investor-view changes and revision\_only=true for authored revisions only; get\_brief provides a current synthesis. Preserve publication, observation and availability clocks. Drain a requested window with unchanged selectors; its continuation cursor differs from the completed next-poll checkpoint. Coverage and resynchronization gaps remain explicit.

## Input parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `person_id` | string | No | |
| `source_id` | string | No | |
| `domain` | "author\_view" \| "author\_condition" \| "engine\_assessment" \| "calculated\_publication\_outcome" \| "distribution" \| "identity\_resolution" \| "provenance" \| "engine\_quality" \| "engine\_plan" | No | |
| `event_kind` | string | No | min length 1; max length 80 |
| `revision_only` | boolean | No | |
| `ticker` | string | No | |
| `entity_id` | string | No | |
| `belief_id` | string | No | |
| `corpus` | string | No | |
| `cursor` | string | No | min length 1; max length 2048 |
| `checkpoint` | string | No | min length 1; max length 2048 |
| `resync` | boolean | No | |
| `as_of` | string | No | |
| `changed_since` | string | No | |
| `limit` | integer | No | min 1; max 50 |

## Transports

* **MCP:** `tools/call` with name `get_changes` 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_changes` 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_changes",
    "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_changes' \
  --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.