Company

Company profile

GET/api/v2/company-profile

Coverage: US / CN / JP
Billing: 20 cr / thousand calls

Returns basic company profiles and external identifiers, one row per company. For prices, use /prices-snapshot; for valuation, use /financial-metrics-snapshot.

If any ticker in a batch fails to resolve or falls in an out-of-scope market, the whole request returns 404 and no partial results are returned.
With multiple tickers, row order is not guaranteed to match the request order; match results by the ticker in each row. A repeated ticker yields only one row.

Query parameters

Parameter	Type	Required	Description
ticker	string	required	Up to 50 tickers, comma-separated.

Response fields

Field	Type	Description
ticker	string	Canonical ticker; always populated
market	stringenum	`US` / `CN` / `JP`; always populated
name	string	Company name in English: natively English for US, and for JP / CN the English name registered with the exchange and the disclosure platform, with companies that have none falling back to the local-language name; identical to `name` in `/tickers`; always populated
name_local	string	Local-language name: Japanese for JP, Chinese for CN; US companies have no local name, so the value is `null`
exchange	stringenum	Exchange MIC (ISO 10383): `XNAS` `XNYS` `XASE` `XSHG` `XSHE` `BJSE` `XTKS`; always populated
country	string	Company country, ISO 3166-1 alpha-2, exposed as-is from the company address on record at the data source, with no normalization. Not the country of incorporation: this column cannot be used to filter by jurisdiction of incorporation (tax, compliance, offshore-structure determinations); always populated
currency	string	Trading currency (ISO 4217); always populated
sector	string	Top-level industry classification from the data source (not GICS; the language of the classification name follows the market: English for US, Chinese for CN, Japanese for JP); `null` where there is no coverage
industry	string	Industry subclassification from the data source (not GICS; the language of the classification name follows the market, same as `sector`); `null` where there is no coverage
listing_date	date	Listing date; `null` when there is no value
website	string	Company website; `null` where there is no value
full_time_employees	int	Employee count; `null` where there is no value
identifiers	object	External identifiers; the object is always present, and each subfield is `null` where there is no value; CIK and CUSIP have values only for US-listed companies

Request

curl -H "X-API-KEY: $DRILLR_API_KEY" \
  "https://gateway.drillr.ai/api/v2/company-profile?ticker=AAPL"

Response · 200

{
  "data": [
    {
      "ticker": "AAPL",
      "market": "US",
      "name": "Apple Inc.",
      "name_local": null,
      "exchange": "XNAS",
      "country": "US",
      "currency": "USD",
      "sector": "Technology",
      "industry": "Consumer Electronics",
      "listing_date": "1980-12-12",
      "website": "https://www.apple.com",
      "full_time_employees": 164000,
      "identifiers": {
        "isin": "US0378331005",
        "cik": "0000320193",
        "cusip": "037833100"
      }
    }
  ]
}

No key yet? Create one under API Keys — it is shown once, so store it where your shell can read it. Connecting an agent over MCP instead? That signs in through the browser and needs no key at all.

Authentication, conventions, rate limits and error shapes are the same for every endpoint — they live on REST API.