List filings

Search indexed SEC filing records for a bounded research or monitoring workflow. Filter by one issuer identifier, form, filing date, text, or a known accession number; results include filing identity and source links. Coverage and freshness reflect the returned records and provenance, not a promise of real-time or complete EDGAR history.

get/v1/filings

Request

  • Base URL: https://api.turos.app
  • URL: https://api.turos.app/v1/filings
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Query parameters

tickerstring

Issuer ticker, for example AAPL. Use ticker, symbol, or cik to scope issuer-specific filing lookups.

symbolstring

Alias for ticker, for customers coming from market-data APIs. If both ticker and symbol are provided, they must match.

cikstring

Issuer Central Index Key. Use ticker, symbol, or cik to scope issuer-specific filing lookups.

formstring

Single SEC form type to filter by, for example 10-K or 8-K.

formsstring

Comma-separated SEC form types to filter by.

fpstring

Fiscal period filter, for example FY, Q1, Q2, Q3, or Q4.

qstring

Text query over indexed filing manifests. Combine it with an issuer, form, or date range for a bounded review set; a match is not a conclusion about the filing.

accession_numberstring

Exact SEC accession-number filter for a known filing.

date_fromstring date

Earliest filing date to include.

date_tostring date

Latest filing date to include; must be on or after date_from.

filing_yearinteger

Calendar filing year filter.

fyinteger

Fiscal-year alias used to derive a filing-date window.

sort'filing_date_desc' | 'filing_date_asc'

Filing date sort order.

limitinteger

Maximum filings to return.

cursorinteger

Zero-based result offset. Use the returned nextCursor while hasMore is true rather than deriving an offset from row IDs.

submission_file_limitinteger

Maximum number of SEC submission files to inspect when reaching further back in history. Raise this only when you need older filings.

view'default' | 'compact' | 'agent'

Response shape. compact is equivalent to mode=compact; agent returns citation fields and snippets without the full section body.

Response

Successful filing search response. Default and compact views return filing-list metadata with full or compact filing records; view=agent returns the runtime agent list envelope with compact filing citation records.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.