getEntity

Look up any SEC filer by ticker or CIK. Returns exchange, SIC industry, incorporation state, address, and more — the same metadata that is pre-attached to every filing from getFilings.

GET/entity

const entity = await client.getEntity(params);

Returns the Entity object, or null if not found.

Parameters

Pass either cik or ticker — not both.

cikstringoptional

SEC CIK number, e.g. 320193

tickerstringoptional

Ticker symbol, e.g. AAPL

Response

Returns an Entity object or null:

cikstringoptional

SEC CIK number

namestringoptional

Legal company name

tickerstring?optional

Primary ticker symbol

exchangestring?optional

Listing exchange, e.g. NASDAQ, NYSE

sicCodestring?optional

Standard Industrial Classification code

sicDescriptionstring?optional

Human-readable SIC industry description

stateOfIncorporationstring?optional

State or country of incorporation

phonestring?optional

Company phone number

websitestring?optional

Company website URL

businessAddressobject?optional

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" });

getNews Authentication