> ## 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 [Ticker Lookup](/v2/ticker-lookup) 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"
```


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