> ## Documentation Index
> Fetch the complete documentation index at: https://docs.insighthread.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /companies — List and Look Up Covered Companies

> Retrieve the full list of 6,000+ US public companies covered by Insighthread, or look up a specific company by ticker to get its profile and recent events.

The `/companies` endpoints let you retrieve the full list of companies covered by the Insighthread News API, or look up a specific company by ticker symbol to validate coverage and retrieve its profile. Use these endpoints to build coverage maps, power search experiences, and verify that a given ticker is active in the Insighthread pipeline before subscribing to its event stream.

## List All Companies

Retrieve a paginated list of all companies covered by the Insighthread News API.

```
GET https://api.insighthread.com/v1/companies
```

### Query Parameters

<ParamField query="search" type="string">
  Filter results by company name or ticker symbol. Partial matches are supported. Example: `search=nvidia` returns NVIDIA Corporation.
</ParamField>

<ParamField query="limit" type="integer" default="50">
  Number of companies to return per page. Default is `50`; maximum is `500`.
</ParamField>

<ParamField query="cursor" type="string">
  Pagination cursor from a previous response. Pass the `next_cursor` value to retrieve the next page.
</ParamField>

### Example Request

```bash theme={null}
curl "https://api.insighthread.com/v1/companies?search=biotech&limit=5" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Example Response

```json theme={null}
{
  "data": [
    {
      "ticker": "REGN",
      "name": "Regeneron Pharmaceuticals, Inc.",
      "exchange": "NASDAQ",
      "sector": "Healthcare",
      "is_covered": true
    },
    {
      "ticker": "MRNA",
      "name": "Moderna, Inc.",
      "exchange": "NASDAQ",
      "sector": "Healthcare",
      "is_covered": true
    },
    {
      "ticker": "IOBT",
      "name": "IO Biotech, Inc.",
      "exchange": "NASDAQ",
      "sector": "Healthcare",
      "is_covered": true
    }
  ],
  "next_cursor": "eyJpZCI6IklPQlQiLCJkaXIiOiJuZXh0In0",
  "total": 312
}
```

## Get a Single Company

Retrieve the full profile and most recent events for a specific company by its ticker symbol.

```
GET https://api.insighthread.com/v1/companies/{ticker}
```

### Path Parameters

<ParamField path="ticker" type="string" required>
  The company's ticker symbol. Case-insensitive. Example: `NVDA`, `AAPL`, `JPM`.
</ParamField>

### Example Request

```bash theme={null}
curl "https://api.insighthread.com/v1/companies/NVDA" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Example Response

```json theme={null}
{
  "ticker": "NVDA",
  "name": "NVIDIA Corporation",
  "exchange": "NASDAQ",
  "sector": "Technology",
  "description": "NVIDIA Corporation designs and manufactures graphics processing units (GPUs), system-on-chip units, and related software for the gaming, professional visualization, data center, and automotive markets.",
  "is_covered": true,
  "recent_events": [
    {
      "id": "evt_8k101_nvda_apr14",
      "event_type": "Mergers and Acquisitions",
      "headline": "NVIDIA acquires Run:ai in $700M all-cash transaction",
      "impact": {
        "score": 4,
        "direction": "positive",
        "label": "Major",
        "bars": 4
      },
      "published_at": "2026-04-14T09:18:33Z"
    },
    {
      "id": "evt_10q_nvda_feb26",
      "event_type": "Corporate Earnings",
      "headline": "NVIDIA reports Q4 FY2026 revenue of $39.3B, beats estimates",
      "impact": {
        "score": 4,
        "direction": "positive",
        "label": "Major",
        "bars": 4
      },
      "published_at": "2026-02-26T21:05:14Z"
    }
  ]
}
```

### Response Fields

<ResponseField name="ticker" type="string">
  The company's ticker symbol as listed on its primary exchange.
</ResponseField>

<ResponseField name="name" type="string">
  Full legal name of the company.
</ResponseField>

<ResponseField name="exchange" type="string">
  Primary exchange on which the company's shares are listed. Example: `NYSE`, `NASDAQ`.
</ResponseField>

<ResponseField name="sector" type="string">
  Industry sector classification. Example: `Technology`, `Healthcare`, `Financials`.
</ResponseField>

<ResponseField name="description" type="string">
  Short business description summarizing the company's primary operations.
</ResponseField>

<ResponseField name="is_covered" type="boolean">
  Whether the company is actively covered by the Insighthread pipeline. A value of `true` indicates the company's SEC filings are being monitored and events will be generated. Always `true` for results returned by the `/companies` endpoints.
</ResponseField>

<ResponseField name="recent_events" type="array">
  Array of the most recent event objects associated with this company. For full event details, use the [GET /events](/api/events) endpoint filtered by `ticker`, or fetch a specific event with [GET /events/{id}](/api/events#get-a-single-event).

  <Expandable title="recent_events item fields">
    <ResponseField name="id" type="string">
      Unique event identifier. Pass to `GET /events/{id}` to retrieve the full event object.
    </ResponseField>

    <ResponseField name="event_type" type="string">
      Event category. One of 35+ possible values. See the [Event Categories](/api/event-categories) reference.
    </ResponseField>

    <ResponseField name="headline" type="string">
      Short, one-sentence headline summarizing the event.
    </ResponseField>

    <ResponseField name="impact" type="object">
      Impact signal for this event. See the [Response Schema](/api/response-schema#event-object) for full `impact` field documentation.
    </ResponseField>

    <ResponseField name="published_at" type="string">
      ISO 8601 timestamp of when Insighthread published this event.
    </ResponseField>
  </Expandable>
</ResponseField>

<Tip>
  Use `GET /companies?search={ticker}` to validate that a ticker is covered before subscribing to its events. If the ticker is not present in the results, it is not yet in the Insighthread pipeline. Contact your account manager to request coverage for a specific company.
</Tip>


## Related topics

- [Insighthread Quickstart: From Sign-Up to First AI Query](/quickstart.md)
- [Company Profiles: Deep Research on Any Public Stock](/features/company-profiles.md)
- [Set Up Insighthread Event Alerts and Notifications](/account/notifications.md)
- [Insider Trade Tracking, Conviction Scoring & Cluster Signals](/features/insider-trades.md)
- [How to Research Any Public Stock Using Insighthread](/guides/research-a-stock.md)