Search filing sections

Search filing sections and snippets with filing-scoped filters and cursor pagination.

get/v1/sections/search

Request

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

Query parameters

qstring

Section search query.

tickerstring

Optional issuer ticker filter. symbol is accepted as an alias.

symbolstring

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

cikstring

Optional issuer CIK filter.

formstring

Optional filing form filter such as 10-K or 10-Q.

filing_idstring

Optional stored filing id to scope section search to a single filing.

filing_yearinteger

Optional filing-year filter.

fyinteger

Optional fiscal-year selector. With ticker, maps to the issuer fiscal-year filing-date window.

yearinteger

Alias for fy when ticker is present.

fpstring

Optional fiscal period selector such as FY, Q1, Q2, Q3, or Q4.

quarterstring

Alias for fp, such as FY, Q1, Q2, Q3, or Q4.

limitinteger

Maximum sections to return.

cursorinteger

Non-negative result offset from a previous page.

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

Search response shape. Use agent for a compact citation-ready shape; compact is accepted for response-format consistency and currently matches the default search rows. Invalid values return invalid_query_parameter with details.acceptedValues.

Response

Section search results with pagination and request tracing metadata.

object'list' required
hasMoreboolean required
nextCursorstring nullable required
queryPathstring nullable
queryPathReasonstring nullable
policyYearsobject nullable
degradedStateobject nullable
responseModestring
includestring[]
requestIdstring required
traceparentstring

Changes

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