sec_filing_browse is the first step in SEC Filing’s progressive-disclosure pattern: given a U.S. ticker, it returns the metadata list of available 10-K / 10-Q / 8-K filings (no section text). Use it to discover what filings exist for a company, then call sec_filing_read to fetch the actual section content — by year / quarter for 10-K / 10-Q, or by accession_number for 8-K (event-driven, many per year). Every filing also carries section_keys — the section codes available for it — so an agent can tell what an 8-K is about before reading a single line.Browse is not semantic search: it accepts only a ticker + optional filing_type filter. No keyword matching, no relevance ranking, no natural-language queries.
The sections you can read from this filing — e.g. 8-K ["item2.02","item9.01","ex99.1"], 10-K ["1","1A","7", …]. An empty [] means none are listed yet. Pass any code to sec_filing_read to pull that section. The codes also tell you what an 8-K is: item2.02 is earnings, item5.02 an executive change — no need to open it first.
Two-step lookup is canonical for SEC filings: sec_filing_browse returns the list of filings (free), then sec_filing_read extracts a specific section (1 credit). Pass the accession_number from browse straight into read for unambiguous targeting.
Every filing carries section_keys — the section codes available for it. For 8-K (many per year, all named “8-K”) this is how an agent picks the right one without reading it: item2.02 = earnings, item5.02 = executive change, ex99.1 = press-release exhibit. Pass the codes you want straight into sec_filing_read’s items.
Published filings never change, so a result stays valid for good. The first lookup for a ticker may take a moment; every repeat is instant.
10-K, 10-Q, and 8-K supported. 20-F and proxy (DEF 14A) filings are not currently supported.
No date-range filter (filed_at_gte / filed_at_lte) and no CIK lookup. Only ticker (+ optional filing_type) is accepted.