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

# Company Lookup

> Look up a company identity card by ticker, domain, qid, CIK, or name.

Use `GET /api/v1/companies` when the question is **who is this company?**
(NVDA, nvidia.com, a CIK, or a name). This is not article search — after you
have a ticker, use [Entity Search](/entity-search/ticker) for mentioning
articles.

Free, no auth required. Empty matches return `200` with `items: []`.
Unexpected lookup failures return `500`.

## List

At least one of `ticker`, `domain`, `qid`, `cik`, or `name` is required.
When more than one is given, lookup uses **qid > ticker > domain > cik >
name** to find candidates; the remaining identifiers must also match.

```bash theme={null}
curl "https://dripstack.com/api/v1/companies?ticker=NVDA"
curl "https://dripstack.com/api/v1/companies?domain=nvidia.com"
```

| Parameter | Required | Description                                                           |
| --------- | -------- | --------------------------------------------------------------------- |
| `ticker`  | one of   | Stock ticker, 1-8 characters (letters/numbers/`.`/`-`)                |
| `domain`  | one of   | Official website host, e.g. `nvidia.com`                              |
| `qid`     | one of   | Company id, e.g. `Q182477`                                            |
| `cik`     | one of   | SEC CIK, 1-10 digits                                                  |
| `name`    | one of   | Company name, minimum 2 characters, when no other identifier is known |
| `limit`   | optional | 1-10, defaults to 5                                                   |

## Response

```json theme={null}
{
  "query": {
    "ticker": "NVDA",
    "domain": null,
    "qid": null,
    "cik": null,
    "name": null
  },
  "count": 1,
  "items": [
    {
      "id": "Q182477",
      "name": "NVIDIA",
      "description": "American technology company",
      "identifiers": {
        "ticker": "NVDA",
        "domain": "nvidia.com",
        "cik": "0001045810",
        "qid": "Q182477"
      }
    }
  ]
}
```

Present `name` plus `identifiers.ticker` / `domain` to users — do not lead
with raw ids.

## One company

`GET /api/v1/companies/{companyId}` returns the same profile object as a list
item. Use the `id` from the list route. Unknown ids and ids that are not
companies return `404`.

```bash theme={null}
curl "https://dripstack.com/api/v1/companies/Q182477"
```