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

> Get SEC filing news

**Get SEC filing news** · Free discovery

Retrieves recent SEC filings for one verified ticker, including filing and acceptance dates, official links and the last observation time. Set include\_earnings=true for issuer-announced earnings schedules where BeliefState has verified SEC evidence. Release dates and webcast times are separate. Free without using account allowance, credits or wallet payment. Missing or stale filing snapshots trigger a read-only SEC metadata lookup. Provider failure preserves stale or unavailable status.

## Input parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `ticker` | string | Yes | |
| `limit` | integer | No | min 1; max 10; default 5 |
| `include_earnings` | boolean | No | Include issuer-announced earnings schedules supported by admitted SEC evidence. |

## Transports

* **MCP:** `tools/call` with name `get_news` at `https://beliefstate.ai/mcp` (account access) or `https://beliefstate.ai/v1/research/mcp` (free discovery; no account or payment). See [MCP integration](https://docs.beliefstate.ai/guides/mcp-server.md).
* **x402 HTTP:** `POST https://beliefstate.ai/v1/research/news` with the arguments as a JSON body. Free; no payment authorization.
* **Related REST resource:** [`GET /v1/sources?view=news`](https://docs.beliefstate.ai/api-reference/sources/find-research-sources-by-name-domain-or-source-id).

## Example request

### MCP

```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_news",
    "arguments": {
      "ticker": "NVDA",
      "limit": 5
    }
  }
}
```

### x402 HTTP

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
curl --request POST \
  --url 'https://beliefstate.ai/v1/research/news' \
  --header 'Content-Type: application/json' \
  --data '{"ticker":"NVDA","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/sources?view=news](https://docs.beliefstate.ai/api-reference/sources/find-research-sources-by-name-domain-or-source-id.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.