getEntity

Look up a company or filer by CIK or ticker. Returns rich metadata including exchange, industry, address, and more.

const entity = await client.getEntity(params);

Returns the Entity object, or null if not found.

Parameters

Pass either cik or ticker — not both.

Parameter	Type	Description
`cik`	string	SEC CIK number, e.g. `"320193"`
`ticker`	string	Ticker symbol, e.g. `"AAPL"`

Response

Field	Type	Description
`cik`	string	SEC CIK number
`name`	string	Legal company name
`ticker`	string?	Primary ticker symbol
`exchange`	string?	Listing exchange, e.g. `"NASDAQ"`, `"NYSE"`
`sicCode`	string?	Standard Industrial Classification code
`sicDescription`	string?	Human-readable SIC industry description
`stateOfIncorporation`	string?	State or country of incorporation
`phone`	string?	Company phone number
`website`	string?	Company website URL
`businessAddress`	object?	Street, city, state, zip of business address

Examples

Look up by ticker

const entity = await client.getEntity({ ticker: "AAPL" });

if (entity) {
  console.log(entity.name);       // "Apple Inc."
  console.log(entity.exchange);   // "NASDAQ"
  console.log(entity.sicDescription); // "Electronic Computers"
}

Look up by CIK

const entity = await client.getEntity({ cik: "320193" });

Enrich filings with entity data

const { filings } = await client.getFilings({ ticker: "TSLA" });

// entity is already included on each filing
for (const filing of filings) {
  console.log(filing.entity?.name, filing.formType);
}

// Or fetch standalone for a profile page
const entity = await client.getEntity({ ticker: "TSLA" });