Reader job: find exact language and preserve its source
Scope an exact-term query to an issuer and filing family where possible. Treat returned filing and section hits as a research queue, then retrieve the selected filing or section before displaying a quotation or conclusion.Run a scoped literal search
q is required. Narrow with ticker or symbol, cik, form, accession_number, filing_year, issuer fiscal year fy or year, and date_from or date_to. limit ranges from 1 through 100 and is a combined search budget split between the filing and section legs; it is not a single globally paginated result list.
The response includes object: "fulltext_search", the echoed query, filings, sections, requestId, and traceparent. Each leg has data and count. A section result can include degradedState when section-search capability is partially unavailable.
Turn a result into evidence
For a content claim, prefer a section hit. Retain its filing identity, section key, source URL or provenance, query filters, andrequestId, then fetch the section by accession:
Choose a different search path when needed
Use semantic search for related language that may not repeat your literal terms. Use filing search to select documents by metadata rather than text. Use section extraction when you already know the accession and item.Production caveats
tickerandsymbolmust agree when both are supplied.- A fiscal-year filter is not the same as a calendar filing-year filter: with an issuer,
fymaps to that issuer’s fiscal filing window;filing_yearselects a calendar filing year. - A non-2xx response or
degradedStateis an unavailable or partial retrieval condition, not a negative search result. - A snippet cannot substitute for reading the source filing, its tables, and its qualifiers.

