# BeliefState

> We read investment research and turn each author’s ideas, reasoning, and risks into knowledge your AI can use.

- [Introduction](https://docs.beliefstate.ai/introduction.md): We read investment research and turn each author’s ideas, reasoning, and risks into knowledge your AI can use.
- [Quick start](https://docs.beliefstate.ai/quickstart.md): Make your first REST request and verify its source evidence.
- [API authentication](https://docs.beliefstate.ai/guides/authentication.md): Choose REST API keys or MCP OAuth and protect credentials.
- [Evidence and provenance](https://docs.beliefstate.ai/concepts/provenance.md): Trace interpreted fields to source evidence and explicit uncertainty.
- [Coverage and limits](https://docs.beliefstate.ai/concepts/coverage.md): Check released tickers and understand known coverage gaps.
- [Cursor pagination](https://docs.beliefstate.ai/guides/pagination.md): Follow cursors to retrieve complete result sets.
- [Historical queries](https://docs.beliefstate.ai/guides/point-in-time.md): Use as_of to read data available at a historical cutoff.
- [MCP integration](https://docs.beliefstate.ai/guides/mcp-server.md): Connect an OAuth-capable AI client to read-only research tools.
- [OpenAPI contract](https://docs.beliefstate.ai/guides/openapi.md): Generate REST clients from the published OpenAPI contract.
- [API versions](https://docs.beliefstate.ai/reference/versioning.md): Track route and schema changes across API releases.
- [Webhook status](https://docs.beliefstate.ai/reference/webhooks.md): See current webhook availability and delivery requirements.
- [Event types](https://docs.beliefstate.ai/reference/webhook-events.md): Review the published event catalog
- [API changelog](https://docs.beliefstate.ai/reference/changelog.md): Review shipped API, MCP, and documentation changes.
- [Common questions](https://docs.beliefstate.ai/reference/faq.md): Find answers on access, coverage, credits, and common errors.
- [Get a cited research brief for a ticker or canonical entity](https://docs.beliefstate.ai/api-reference/brief/get-a-cited-research-brief-for-a-ticker-or-canonical-entity.md): Use exactly one of ticker or released entity_id. Non-listing entity briefs return cited attributed views, recorded conditions, explicit price and benchmark capability gaps, omission counts and a get_beliefs continuation. Default overview returns at most five views; detail=full returns the selected c…
- [Find investor beliefs or inspect a full record](https://docs.beliefstate.ai/api-reference/beliefs/find-investor-beliefs-or-inspect-a-full-record.md): Returns compact, filterable, point in time summaries of released investor beliefs. Use belief_id for decision_review (current evidence comparison or an explicit review gap) and the complete record with its documented investor twin: source linked memories, stated conditions, separate author and condi…
- [Find tickers with available research](https://docs.beliefstate.ai/api-reference/tickers/find-tickers-with-available-research.md): Without q, returns released direct ticker coverage, belief and investor counts, and observation dates. With q, searches the current SEC registered US company directory by ticker or company name and labels direct research availability. Directory coverage is not global. Public discovery is free; omit…
- [Find research sources by name, domain, or source ID](https://docs.beliefstate.ai/api-reference/sources/find-research-sources-by-name-domain-or-source-id.md): Search with q, filter by domain or ticker, or select one source_id. Every result uses the same source record array and pagination envelope. An unknown source ID returns an empty array. Indexed sources are not automatically authorized corpus material.
- [Check API access, credit balance, and usage metering](https://docs.beliefstate.ai/api-reference/access/check-api-access-credit-balance-and-usage-metering.md)

## OpenAPI Specs

- [openapi](https://beliefstate.ai/openapi.json)

## Optional

- [Connect AI](https://beliefstate.ai/connect)


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