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

> Get companies

**Get companies** · Free discovery

Find SEC-registered U.S. companies and selected verified international listings by symbol or name. Search by market, sector or exchange-qualified symbol, such as Indian banks, Canadian stocks or XTAI:2330. Use the returned selector with get\_company\_snapshot for available cited issuer facts. Listing identity and released investor research are reported separately. Free.

## Input parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `q` | string | Yes | Search the current SEC company directory by ticker or name, independently of direct research coverage. Omit as\_of. min length 1; max length 80 |

## Transports

* **MCP:** `tools/call` with name `get_companies` 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).
* **Public HTTP:** `GET https://beliefstate.ai/v1/tickers?q=%3Cq%3E`. Free discovery; no payment authorization.
* **Related REST resource:** [`GET /v1/tickers`](https://docs.beliefstate.ai/api-reference/tickers/find-tickers-with-available-research).

## Example request

### MCP

```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_companies",
    "arguments": {
      "q": "<q>"
    }
  }
}
```

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/tickers](https://docs.beliefstate.ai/api-reference/tickers/find-tickers-with-available-research.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.