Search and list SEC filings by company (CIK), form type, date range, 8-K item codes and excluded forms, optionally with a full-text query over filing bodies and by company facts (market cap, float, price, sector, industry, exchange, company type, foreign issuer, recent IPO). Rows carry `id` (the internal filingId used by the filing-document and exhibit tools), cik, company_name, accession_number, form_type, filing_date, acceptedAt, primaryDocument, bodyStored and itemNumbers (plus `rank` and `snippet` with `q`); `pagination` has `total`, `totalRelation` ("eq" exact; "gte" a lower bound cut at 10,000, when `totalEstimate` is "about N"), `hasMore` and `nextCursor`. The `ciks` filter matches the filing's own CIK: a Form 4 filed under the reporting owner's CIK is not returned for the issuer's CIK. Coverage: Signal8's SEC EDGAR archive, updated through the day, in its held range (see `archiveFrom` in each response; currently from late 2021, expanding back to 2016 as the history backfill fills in). Before archiveFrom it holds only a scatter, so absence before archiveFrom is not evidence a filing was never filed; SEC EDGAR itself covers earlier periods. Record-only rows (bodyStored: false) have no stored body; the document is at its sec.gov URL. Every response carries `archiveFrom` and `rangeStartsBeforeArchive`: a range with no dateFrom or starting before archiveFrom is not definitive (`searchIndex.complete: false`, `reason: "outside_held_range"`, `heldFrom`): an empty result then means the archive holds no match from archiveFrom onward, not that no such filing exists. An empty text result is definitive only when `searchIndex.complete` is true. Full-text `q`: Query syntax: unquoted words all have to appear (any order, any distance); "quoted phrase" = exact wording; OR between alternatives (merger OR acquisition); -word or -"phrase" to exclude; w1 NEAR/10 w2 (also NEAR(10), or bare NEAR = within 10) = words close together; word* = prefix of 4+ letters (dilut* matches dilution, dilutive); $AAPL or a capitalised ticker scopes to that company; a form code (8-K, 10-Q, S-1), "item 5.02" / "8-K 1.05" and a bare year (2024) scope to that form / 8-K item / year. The archive's reading of the query is in `meta.understanding` (understand=false searches the words literally). facets=true adds `facets` per form / year / 8-K item over the whole result set (absent = not measured, never zero). sort=relevance caps page 1 per company; meta.diversity {maxPerCompany, hidden} names who has more (page with nextCursor or filter by CIK). section / exhibitTypes filters apply only when meta.sections / appliedFilters confirm them; otherwise meta.unsupported says why and the whole filing was searched. Company filters (minMarketCap … recentIpo): only issuer-filed forms are searched (third-party Form 4 / 144 / 13D/G go to `companyFilter.droppedForms` unless `companyFilter.subjectMatch` is true; with no formTypes the default is 10-K, 10-Q, 8-K, S-1, S-3, DEF 14A, 20-F, 40-F, 6-K); companies with no measured value are excluded, never assumed (`companyFilter.unknown` counts them); an unknown value is a 400 listing allowed names; when the archive cannot answer, the call fails with COMPANY_FILTER_NOT_APPLIED and never returns unfiltered rows; results are cursor-paged, cannot combine with acceptedFrom/acceptedTo/bodyStored, and carry no snippet. Results are filings, not a company list or count.
View input schema
{
"type": "object",
"properties": {
"ciks": {
"type": "string",
"description": "Comma-separated CIK numbers to filter by (e.g., \"320193,1018724\"; zero-padded also accepted)"
},
"q": {
"type": "string",
"maxLength": 500,
"description": "Full-text query over filing bodies. Query syntax: unquoted words all have to appear (any order, any distance); \"quoted phrase\" = exact wording; OR between alternatives (merger OR acquisition); -word or -\"phrase\" to exclude; w1 NEAR/10 w2 (also NEAR(10), or bare NEAR = within 10) = words close together; word* = prefix of 4+ letters (dilut* matches dilution, dilutive); $AAPL or a capitalised ticker scopes to that company; a form code (8-K, 10-Q, S-1), \"item 5.02\" / \"8-K 1.05\" and a bare year (2024) scope to that form / 8-K item / year. Example: '$AAPL \"share repurchase\" -\"no longer\"', 'cyber* NEAR/10 incident', 'item 5.02 resign*'."
},
"sort": {
"type": "string",
"enum": [
"newest",
"relevance"
],
"description": "newest (by acceptance time, default) or relevance (requires q; best match first)"
},
"match": {
"type": "string",
"enum": [
"exact",
"stemmed"
],
"description": "Word matching for q. exact = a word matches only itself (\"split\" does not match \"splits\" or \"splitting\"), which is EDGAR full-text search's own behaviour; stemmed = English word variations also match. Default when omitted: stemmed. The mode actually applied is in the response's meta.matchMode (with meta.matchModeFallbackReason when it differs from the one asked for); meta.engine names the search engine. Ignored without q."
},
"facets": {
"type": "boolean",
"description": "true = also return `facets`: { forms, years, items }, each a list of { value, count } over the whole result set (not just this page). Present only when the archive measured them (its OpenSearch engine); absent means not measured, not zero. Default false."
},
"understand": {
"type": "boolean",
"description": "Query understanding (default true): the archive recognises tickers/$TICKER, company names, form codes, \"item N.NN\" and expands synonyms, reporting what it applied in meta.understanding. false = search the words literally (also disables synonym expansion). Ignored without q."
},
"section": {
"type": "string",
"maxLength": 400,
"description": "Restricts matching to sections (comma-separated): business, risk_factors, cybersecurity, legal_proceedings, mdna, market_risk, controls (10-K/10-Q/20-F narrative items, by meaning: mdna is 10-K Item 7, 10-Q Part I Item 2 and 20-F Item 5), ex99 (press-release / EX-99.x exhibit text) and item_X_YY (the text under an 8-K item, e.g. item_5_02). Aliases: mda, risk, legal, cyber, press_release, 5.02. Unknown names are a 400. Requires q. Applied only when the response's meta.sections names it; otherwise meta.unsupported says why (e.g. the archive index does not have sections yet) and matches may come from anywhere in the filing."
},
"exhibitTypes": {
"type": "string",
"maxLength": 400,
"description": "Keeps only filings carrying any of these exhibit types (comma-separated): a family such as EX-10 (material contracts) matches every member (EX-10.1, EX-10.2…); an exact type such as EX-99.1 (usually the press release) only itself. Others: EX-97 clawback policy, EX-3 charter/bylaws, EX-4 instruments/warrants, EX-21 subsidiaries, EX-23 consents. \"10.1\" is accepted for EX-10.1. Listed in appliedFilters when the rows prove it; otherwise in ignoredFilters / meta.unsupported, and the rows are then unfiltered."
},
"matchedSections": {
"type": "boolean",
"description": "Per-row `matchedSections` (default true): the sections the text matched in. Absent on a row means not measured (index without sections), not \"matched nowhere\". Ignored without q."
},
"cursor": {
"type": "string",
"description": "Opaque keyset cursor from a previous response's pagination.nextCursor. Stable for deep paging while new filings arrive (page is not). Required for page 2+ of a company-filtered search."
},
"page": {
"type": "number",
"minimum": 1,
"description": "Page number (1-indexed, default: 1). Ignored when cursor is set; not allowed with company filters."
},
"pageSize": {
"type": "number",
"minimum": 1,
"maximum": 100,
"description": "Results per page (default: 25, max: 100)"
},
"formTypes": {
"type": "string",
"description": "Comma-separated form types (e.g., \"10-K,10-Q,8-K,S-1,S-3,424B5\"). Exact match; amendments (e.g. \"10-K/A\") match only when listed. (With company filters, amendments are added automatically.)"
},
"excludeForms": {
"type": "string",
"description": "Comma-separated form types to exclude (e.g., \"4,13F-HR\"). Exact match."
},
"items": {
"type": "string",
"description": "Comma-separated 8-K item codes, all required (e.g., \"2.02,9.01\" = results + financial statements; \"5.02\" = officer/director changes; \"1.01\" = material agreements; \"3.01\" = delisting notice)."
},
"dateFrom": {
"type": "string",
"description": "Start filing date (YYYY-MM-DD). The archive only holds filings from its `archiveFrom` date (stated in every response; currently late 2021, expanding back to 2016): omitting dateFrom, or starting earlier, makes an empty result non-definitive."
},
"dateTo": {
"type": "string",
"description": "End filing date (YYYY-MM-DD)"
},
"minMarketCap": {
"type": "number",
"minimum": 0,
"description": "Company filter. Minimum market cap in USD (price × shares outstanding), e.g. 50000000 for $50M"
},
"maxMarketCap": {
"type": "number",
"minimum": 0,
"description": "Company filter. Maximum market cap in USD, e.g. 300000000 for under $300M"
},
"minFloat": {
"type": "number",
"minimum": 0,
"description": "Company filter. Minimum public float, in shares"
},
"maxFloat": {
"type": "number",
"minimum": 0,
"description": "Company filter. Maximum public float, in shares"
},
"minPrice": {
"type": "number",
"minimum": 0,
"description": "Company filter. Minimum latest share price in USD"
},
"maxPrice": {
"type": "number",
"minimum": 0,
"description": "Company filter. Maximum latest share price in USD"
},
"sectors": {
"type": "string",
"description": "Company filter. Sector names separated by \"|\" (or a bare comma), exact and case-sensitive (e.g. \"Healthcare|Technology\"). An unknown name returns a 400 listing every valid sector."
},
"industries": {
"type": "string",
"description": "Company filter. Industry names separated by \"|\", exact and case-sensitive (e.g. \"Biotechnology|Airlines, Airports & Air Services\"; some names contain \", \", so \"|\" is the safe separator; a bare comma with no space after it also separates). An unknown name returns a 400 listing every valid industry."
},
"exchanges": {
"type": "string",
"description": "Company filter. Comma-separated listing venues: NASDAQ, NYSE, AMEX (= NYSE American), OTC"
},
"companyTypes": {
"type": "string",
"description": "Company filter. Comma-separated: operating, fund (registered funds/ETFs; adds N-CSR, N-CEN, N-PX, 485BPOS, 497/497K to the default forms), spac (blank-check companies)"
},
"foreignIssuer": {
"type": "boolean",
"description": "Company filter. true = companies with foreign-issuer evidence (a 20-F, 40-F or 6-K seen, or an ADR listing); false = none seen since the evidence log began (companyFilter.foreignEvidenceSince)"
},
"recentIpo": {
"type": "boolean",
"description": "Company filter. true = first listed within the last 365 days, with no evidence of earlier public status (renames and relistings are excluded). false is the same as omitting it."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}