> ## Documentation Index
> Fetch the complete documentation index at: https://docs.useellis.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 Useellis, 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 Useellis 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 Useellis pipeline before subscribing to its event stream.

## List All Companies

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

```text theme={null}
GET https://api.insighthread.com/v1/companies
```

### Query Parameters

**search** `string`

Filter results by company name or ticker symbol. Partial matches are supported. Example: `search=nvidia` returns NVIDIA Corporation.

**limit** `integer` (default: 50)

Number of companies to return per page. Default is `50`; maximum is `500`.

**cursor** `string`

Pagination cursor from a previous response. Pass the `next_cursor` value to retrieve the next page.

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

```text theme={null}
GET https://api.insighthread.com/v1/companies/{ticker}
```

### Path Parameters

**ticker** `string` *required*

The company's ticker symbol. Case-insensitive. Example: `NVDA`, `AAPL`, `JPM`.

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

**ticker** `string`

The company's ticker symbol as listed on its primary exchange.

**name** `string`

Full legal name of the company.

**exchange** `string`

Primary exchange on which the company's shares are listed. Example: `NYSE`, `NASDAQ`.

**sector** `string`

Industry sector classification. Example: `Technology`, `Healthcare`, `Financials`.

**description** `string`

Short business description summarizing the company's primary operations.

**is\_covered** `boolean`

Whether the company is actively covered by the Useellis 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.

**recent\_events** `array`

Array of the most recent event objects associated with this company. For full event details, use the [GET /events](https://docs.useellis.com/api/events.md) endpoint filtered by `ticker`, or fetch a specific event with [GET /events/](https://docs.useellis.com/api/events.md#get-a-single-event){id}.

**recent\_events item fields**

**id** `string`

Unique event identifier. Pass to `GET /events/{id}` to retrieve the full event object.

**event\_type** `string`

Event category. One of 35+ possible values. See the [Event Categories](https://docs.useellis.com/api/event-categories.md) reference.

**headline** `string`

Short, one-sentence headline summarizing the event.

**impact** `object`

Impact signal for this event. See the [Response Schema](https://docs.useellis.com/api/response-schema.md#event-object) for full `impact` field documentation.

**published\_at** `string`

ISO 8601 timestamp of when Useellis published this event.

> [!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 Useellis pipeline. Contact your account manager to request coverage for a specific company.


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