{"uid":"cap_PtkMuS5L6Af1HxIskPK0b","slug":"sec-full-text-search-cdce782f","name":"SEC Full-Text Search","description":"Full-text search of SEC EDGAR filings since 2001: which companies mention a phrase such as 'material weakness', 'going concern', 'tariff', a product or a person. Filter by form (10-K, 8-K, S-1, ...), company and date. Each hit: company, ticker, form, date, document link and the paid call that reads it; plus top companies and forms. No match is free. $0.01 USDC per call.","url":"https://x402-agent-api.onrender.com/api/v1/sec-full-text-search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"cik":{"anyOf":[{"type":"string","pattern":"^\\d{1,10}$"},{"type":"integer","maximum":9007199254740991,"exclusiveMinimum":0}],"description":"SEC Central Index Key, e.g. 320193. Use this, `ticker` or `company`."},"forms":{"type":"array","items":{"type":"string","pattern":"^[A-Z0-9][A-Z0-9 ./-]{0,15}$"},"maxItems":20,"minItems":1,"description":"Only these form types, e.g. [\"10-K\", \"10-Q\"] or [\"8-K\"], [\"S-1\"], [\"DEF 14A\"]. Default: all forms."},"limit":{"type":"integer","default":20,"maximum":50,"minimum":1,"description":"How many documents to return, most relevant first (1-50, default 20)."},"query":{"type":"string","maxLength":500,"minLength":2,"description":"What to search for in the filings' text. Put an exact phrase in double quotes, e.g. \"\\\"material weakness\\\"\" or \"\\\"going concern\\\" Nasdaq\"; words outside quotes must all appear."},"since":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Only documents filed on or after this date (YYYY-MM-DD). Full-text search covers 2001 on."},"until":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Only documents filed on or before this date (YYYY-MM-DD)."},"offset":{"type":"integer","default":0,"maximum":9900,"minimum":0,"description":"Skip this many results; pass the previous response's next_offset to page through more."},"ticker":{"type":"string","pattern":"^[A-Z][A-Z0-9.\\-]{0,9}$","description":"US stock ticker, e.g. AAPL, MSFT, BRK-B. Use this, `cik` or `company`."},"company":{"type":"string","maxLength":120,"minLength":2,"description":"Company name, e.g. \"Apple\" or \"Coca-Cola\". Use this, `ticker` or `cik`; a name matching several companies returns their tickers, free."}}},"responseSchema":{"type":"json","example":{"count":1,"forms":[{"form":"10-K","hits":1843}],"query":"\"material weakness\"","offset":0,"source":"sec-edgar-full-text-search","results":[{"cik":"1234567","form":"10-K","filed":"2026-03-16","items":[],"ticker":"EXMP","company":"Example Holdings Corp.","location":"Austin, TX","next_call":{"tool":"sec_filing_section","price":"$0.01","arguments":{"ticker":"EXMP","section":"risk_factors","accession_number":"0001234567-26-000012"}},"description":"ANNUAL REPORT","document_url":"https://www.sec.gov/Archives/edgar/data/1234567/000123456726000012/exmp-20251231.htm","document_type":"10-K","period_ending":"2025-12-31","accession_number":"0001234567-26-000012","filing_index_url":"https://www.sec.gov/Archives/edgar/data/1234567/000123456726000012/0001234567-26-000012-index.htm"}],"next_calls":[{"why":"Who is Example Holdings Corp.?","tool":"company_profile","price":"$0.01","arguments":{"ticker":"EXMP"}}],"search_url":"https://www.sec.gov/edgar/search/#/q=%22material+weakness%22&forms=10-K&dateRange=custom&startdt=2026-01-01&enddt=2026-10-06","total_hits":1843,"next_offset":1,"top_companies":[{"cik":"1234567","hits":3,"ticker":"EXMP","company":"Example Holdings Corp."}],"total_is_lower_bound":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HfaKuoq1dX9GJ8Gje7QPo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search the full text of SEC filings (10-K, 10-Q, 8-K, etc.) by keyword or exact phrase, returning ranked matching documents with filing metadata and next-step guidance.","exampleAgentPrompt":"Search SEC filings for the exact phrase 'material weakness' in 10-K filings submitted since 2024-01-01 — return up to 20 results for companies in the semiconductor sector.","exampleUseCases":[{"title":"Screening for going-concern disclosures","prompt":"Search all 10-K and 10-Q filings since January 2024 for the phrase 'going concern' and show me which companies disclosed it most frequently, up to 30 results."},{"title":"Competitive intelligence on AI risk disclosures","prompt":"Find every 10-K filed by Microsoft, Alphabet, or Meta that mentions 'AI regulation' or 'artificial intelligence risk' — search by their tickers MSFT, GOOGL, and META and return the 20 most relevant results."},{"title":"Litigation keyword research across all filers","prompt":"Search all SEC filings since 2022 for the exact phrase 'PFAS liability' across any form type and show me up to 50 results sorted by relevance so I can see which companies are disclosing this exposure."}],"resultDescription":"Returns a ranked list of up to 50 matching SEC documents, each with company name, ticker, CIK, form type, filing date, period ending, accession number, direct document URL, filing index URL, and a suggested next-call (e.g. read a specific section). Also includes total hit count, a breakdown of hits by form type, top companies by hit frequency, a link to the EDGAR search UI, and pagination offset for retrieving more results.","failureModes":["Query too short (under 2 characters) returns validation error","No results found if the search terms do not appear in any indexed filing","Company name matching multiple tickers returns a disambiguation list instead of filing results","Date range outside 2001–present returns empty results (full-text index starts 2001)","Payment required (HTTP 402) if x402 payment not completed before the call","Rate limiting or server errors from underlying EDGAR full-text search API","Invalid form type pattern causes schema validation failure"],"whenToPreferThis":"Use this endpoint when you need to discover which SEC filings contain a specific keyword, phrase, or topic across the entire EDGAR universe or for a specific company — especially for compliance screening, investment research, or competitive analysis. Prefer it over sec_list_filings when you have a search term rather than just wanting to enumerate filings, and over sec_filing_section when you don't yet know which specific filing or accession number to read.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:47:14.940Z","isFirstParty":false,"canonicalSlug":"sec-full-text-search-cdce782f"}