Entities

Search and retrieve SEC-registered entity information.

entityLookup()

Search for SEC entities by ticker, CIK, name, exchange, state, and more.

Parameters

Name	Type	Description
`tickers`	string[]	Filter by ticker symbols
`ciks`	string[]	Filter by CIK numbers
`names`	string[]	Search by company name (partial match)
`exchanges`	string[]	Filter by exchange (NYSE, NASDAQ, etc.)
`states`	string[]	Filter by state of incorporation
`sics`	string[]	Filter by SIC codes
`from`	number	Pagination start index
`to`	number	Pagination end index

By Ticker

typescript

const result = await client.entityLookup({ tickers: ['AAPL', 'MSFT'] });

for (const entity of result.entities) {
  console.log(`${entity.name} (CIK: ${entity.cik})`);
  console.log(`  Tickers: ${entity.tickers?.join(', ')}`);
  console.log(`  SIC: ${entity.sic} - ${entity.sicDescription}`);
}

By Exchange and State

typescript

// Find NASDAQ companies in California
const result = await client.entityLookup({
  exchanges: ['NASDAQ'],
  states: ['CA'],
  to: 10
});

console.log(`Found ${result.count} entities`);

Response Structure

EntityInfotypescript

interface EntityInfo {
  cik: string;
  name?: string;
  entityType?: 'operating' | 'investment' | 'other';
  sic?: string;
  sicDescription?: string;
  tickers?: string[];
  exchanges?: string[];
  stateOfIncorporation?: string;
  fiscalYearEnd?: string;
  website?: string;
}