Filings

Search and retrieve SEC filing information.

filingLookup()

Search for SEC filings by company, form type, date range, and more.

Parameters

Name	Type	Description
`tickers`	string[]	Filter by ticker symbols
`ciks`	string[]	Filter by CIK numbers
`form_types`	string[]	Filter by form types (10-K, 10-Q, 8-K, etc.)
`date_from`	string	Start date (YYYY-MM-DD)
`date_to`	string	End date (YYYY-MM-DD)
`from`	number	Pagination start index
`to`	number	Pagination end index

Search Filingstypescript

const result = await client.filingLookup({
  tickers: ['AAPL'],
  form_types: ['10-K', '10-Q'],
  date_from: '2023-01-01',
  to: 10
});

console.log(`Found ${result.count} filings`);
for (const filing of result.filings) {
  console.log(`${filing.form} - ${filing.filingDate} - ${filing.accessionNumber}`);
}

getFilingInfo()

Get detailed information about a specific filing including its documents.

typescript

const info = await client.getFilingInfo({
  accession_number: '0000320193-24-000123'
});

console.log(`Form: ${info.form}`);
console.log(`Filed: ${info.filingDate}`);
console.log(`Documents:`);
for (const doc of info.documents || []) {
  console.log(`  ${doc.sequence}: ${doc.fileName} (${doc.type})`);
}

getFilingSections()

Get the table of contents and sections from a filing.

typescript

const sections = await client.getFilingSections({
  accession_number: '0000320193-24-000123'
});

for (const section of sections.sections || []) {
  console.log(`${section.title}`);
}