Reader job: select a filing with a reproducible query
Start with an issuer, a form family, and a date or fiscal boundary. Store the request and the selected filing identity, then retrieve the source section that supports a finding. This separation keeps document selection distinct from disclosure interpretation.Search a bounded filing universe
GET /v1/filings accepts ticker or cik; form or forms; date_from and date_to; filing_year or fy; fp; text q; accession_number; limit; and cursor. The response includes records, hasMore, and nextCursor. Persist the returned accessionNumber, filing date, form, filer identity, and filing URL before choosing content.
When a document is already known, fetch its manifest directly:
Use the right route after discovery
The JavaScript SDK provides
client.searchFilings(params), client.paginateFilings(params), client.latestFiling(params), and client.filingByAccession(accessionNumber, params). Hosted MCP offers filings.search for a constrained manifest query and sections.get for source retrieval. Use REST or an SDK when you need the full filter or cursor surface.
Caveats for production workflows
- Keep a cursor with its original filters; do not apply it to a changed issuer, form, or date range.
- A form-only latest query can follow a current daily-index path and be terminal with
hasMore: false. filingDateis SEC receipt date, not necessarily a report period, market event time, or derived-data availability time.- An empty list does not establish that an issuer has no SEC filings. Recheck identifiers, form family, date bounds, and the coverage boundary.
- Save the request filters, accession, filing URL, and
requestIdwith a selected document so another reviewer can reproduce it.

