SEC EDGAR API: Search filings by phrase
Finds SEC EDGAR company filings that mention an exact phrase, optionally limited to a company, a filing category and a filing date range, ranked by search relevance; one entry per filing.
Unofficial. Not affiliated with or endorsed by SEC EDGAR.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Phrase, required
phrase Exact words to find in filings, for example: supply chain disruption.
supply chain disruption
- Company optional
company Company name or ticker to limit matches, for example: Apple or AAPL.
(default)
- End Date optional
end_date Last filing date as YYYY-MM-DD, for example: 2026-09-28. Defaults to today.
Not set
- Form Type optional
form_type Filing category, for example: annual_report.
current_report
One of
any,annual_report,quarterly_report,current_report,proxy_statement,registration. Defaultany.- Start Date optional
start_date First filing date as YYYY-MM-DD, for example: 2025-01-01. Defaults to one year ago; earliest is 2001-01-01.
Not set
- Max Results optional
max_results Maximum number of filings, for example: 20 (up to 100).
100
Whole number from 1 to 100. Default
20.
Input as JSON
{ "phrase": "supply chain disruption", "form_type": "current_report", "max_results": 100}Output
{ "filings": [ { "cik": "0000807882", "form_type": "8-K", "filing_date": "2025-12-23", "company_name": "JACK IN THE BOX INC", "form_meaning": "Current report", "document_link": "https://www.sec.gov/Archives/edgar/data/807882/000080788225000081/ex991-pressreleasexdeltaco.htm" , "accession_number": "0000807882-25-000081", "report_period_date": "2025-12-22", "matching_text_excerpt": null }, { "cik": "0000807882", "form_type": "8-K", "filing_date": "2026-06-15", "company_name": "JACK IN THE BOX INC", "form_meaning": "Current report", "document_link": "https://www.sec.gov/Archives/edgar/data/807882/000080788226000075/ex991-pressreleasexdebtpri.htm" , "accession_number": "0000807882-26-000075", "report_period_date": "2026-06-12", "matching_text_excerpt": null }, { "cik": "0000807882", "form_type": "8-K", "filing_date": "2026-06-23", "company_name": "JACK IN THE BOX INC", "form_meaning": "Current report", "document_link": "https://www.sec.gov/Archives/edgar/data/807882/000080788226000079/ex991-pressreleasexdebtclo.htm" , "accession_number": "0000807882-26-000079", "report_period_date": "2026-06-23", "matching_text_excerpt": null } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"sec.gov/search_filings","input":{"phrase":"supply chain disruption","form_type":"current_report","max_results":100}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "sec.gov/search_filings" , "input": { "phrase": "supply chain disruption", "form_type": "current_report", "max_results": 100 }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "sec.gov/search_filings" , "input": { "phrase": "supply chain disruption", "form_type": "current_report", "max_results": 100 } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run sec.gov/search_filings# with {"phrase":"supply chain disruption","form_type":"current_report","max_results":100}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "phrase" ], "properties": { "phrase": { "type": "string", "minLength": 1, "description": "Exact words to find in filings, for example: supply chain disruption." }, "company": { "type": "string", "default": "", "description": "Company name or ticker to limit matches, for example: Apple or AAPL." }, "end_date": { "type": "string", "description": "Last filing date as YYYY-MM-DD, for example: 2026-09-28. Defaults to today." }, "form_type": { "enum": [ "any", "annual_report", "quarterly_report", "current_report", "proxy_statement", "registration" ], "type": "string", "default": "any", "description": "Filing category, for example: annual_report." }, "start_date": { "type": "string", "description": "First filing date as YYYY-MM-DD, for example: 2025-01-01. Defaults to one year ago; earliest is 2001-01-01." }, "max_results": { "type": "integer", "default": 20, "maximum": 100, "minimum": 1, "description": "Maximum number of filings, for example: 20 (up to 100)." } }}Output schema
{ "type": "object", "required": [ "filings" ], "properties": { "filings": { "type": "array", "items": { "type": "object", "required": [ "company_name", "form_type", "form_meaning", "filing_date", "report_period_date", "matching_text_excerpt", "document_link", "cik", "accession_number" ], "properties": { "cik": { "type": "string", "description": "SEC company identification number.", "x-fous-developer": true }, "form_type": { "type": [ "string", "null" ], "description": "SEC filing form code, such as 10-K." }, "filing_date": { "type": [ "string", "null" ], "format": "date", "description": "Date the filing was filed." }, "company_name": { "type": [ "string", "null" ], "description": "Name of the filing company." }, "form_meaning": { "type": [ "string", "null" ], "description": "Plain-language meaning of the filing form." }, "document_link": { "type": "string", "description": "Link to the matching filing document." }, "accession_number": { "type": "string", "description": "SEC filing accession number.", "x-fous-developer": true }, "report_period_date": { "type": [ "string", "null" ], "format": "date", "description": "Period date covered by the filing, if provided." }, "matching_text_excerpt": { "type": [ "string", "null" ], "description": "Matching text excerpt when supplied by EDGAR." } }, "additionalProperties": false }, "description": "Company filings ranked by phrase relevance." } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
sec.gov/search_filings- Returns
- company name, form type and meaning, filing date, report period, excerpt, document link, CIK, accession number
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method sec.gov/search_filings with the inputs above.
Ask your agent
- Find 10-K annual reports filed since January 2024 that mention "going concern doubt" — give me the company names, filing dates and links to the documents.
- Which Tesla filings on SEC EDGAR from the past year contain the exact phrase "regulatory credits"? I need the excerpts and accession numbers.
- Pull up to 50 8-K current reports filed between 2023-03-01 and 2023-06-30 that use the words "Silicon Valley Bank".
- Search EDGAR for proxy statements that mention "clawback policy" for Microsoft, any date from 2020 onward.
- Show me quarterly reports from NVDA filed in 2025 that reference "export restrictions", with report periods and CIK.
See more
All SEC EDGAR methodsFinds a public company by name or ticker in SEC EDGAR and lists its filings, newest first, optionally narrowed by filing type and filing date.
sec.gov/get_company_filingsLooks up a public company by name or ticker on SEC EDGAR and returns its reported annual or quarterly financial figures from XBRL company facts. Quarterly flows are derived from year-to-date totals when no quarterly figure is filed. Unavailable figures are null.
sec.gov/get_company_financialsLists stock transactions reported on Form 4 filings by a company's officers, directors and major owners, newest first. Trades without a reported price have no calculated value.
sec.gov/list_insider_tradesLists a UK company's Companies House filings, newest first, with date, form code, type, description, page count and PDF link. Finds the company by name, company number or Companies House link; a category picks accounts, confirmation statements, officers, address, capital, charges or incorporation filings.
find-and-update.company-information.service.gov.uk/list_filing_historySearches CNBC-published articles by keyword, with optional publication date range, sort order and pagination. Excludes videos, wire stories and press releases.
cnbc.com/search_newsFinds PR Newswire press releases by company name or keywords, newest first, with optional publication date filters.
prnewswire.com/search_press_releasesFinds FDA medical device recalls whose product description or recalling company matches a phrase, newest first, with the recall class and its health-risk meaning from each FDA recall page. An optional start date limits recalls to those initiated on or after it.
fda.gov/search_device_recallsGets earnings reports for a date range, or the upcoming reports and up to four previous reports for one company.
finance.yahoo.com/get_earnings_calendar