Reference · Filings
list_filings
A company's SEC filings, newest first: form, filing date, period, accession number, description and the sec.gov link. Filter by one form type (10-K, 10-Q, 8-K, 4, DEF 14A...).
REST
GET https://api.fundalyze.ai/api/public/v1/list_filingsMCPlist_filingsParameters
| Parameter | Type | Default | Description |
|---|---|---|---|
tickerrequired | stringup to 12 characters | — | US ticker symbol, e.g. AAPL or BRK-B. Use search_companies when unsure. |
form_type | string | — | Keep one SEC form type, exact match, e.g. 10-K, 10-Q, 8-K, 4, DEF 14A, 20-F. Omit for every form. |
limit | integer1–50 | 20 | Rows to return, newest first, 1-50. |
Example
A real call and its answer. Replace fdz_live_YOUR_KEY with your key, or set FUNDALYZE_API_KEY for the Python and JavaScript versions.
list_filings: curl
curl -H "Authorization: Bearer fdz_live_YOUR_KEY" "https://api.fundalyze.ai/api/public/v1/list_filings?ticker=AAPL&form_type=10-K&limit=5"list_filings: Python
import os
import requests
response = requests.get(
"https://api.fundalyze.ai/api/public/v1/list_filings",
params={
"ticker": "AAPL",
"form_type": "10-K",
"limit": 5,
},
headers={"Authorization": f"Bearer {os.environ['FUNDALYZE_API_KEY']}"},
timeout=60,
)
response.raise_for_status()
answer = response.json()
print(answer["text"])
print("Calls left today:", response.headers.get("X-Quota-Remaining"))list_filings: JavaScript
const params = new URLSearchParams()
params.append("ticker", "AAPL")
params.append("form_type", "10-K")
params.append("limit", "5")
const response = await fetch(`https://api.fundalyze.ai/api/public/v1/list_filings?${params}`, {
headers: { Authorization: `Bearer ${process.env.FUNDALYZE_API_KEY}` },
})
const answer = await response.json()
if (!response.ok) throw new Error(`${response.status}: ${answer.detail}`)
console.log(answer.text)
console.log('Calls left today:', response.headers.get('X-Quota-Remaining'))list_filings: MCP
The same call as an MCP tools/call: what an assistant sends.
{
"name": "list_filings",
"arguments": {
"ticker": "AAPL",
"form_type": "10-K",
"limit": 5
}
}Response
Generated from live data on Oct 7, 2026; figures change as filings arrive.
list_filings: response text
What an assistant reads (and what MCP returns).
AAPL · 10-K filings · newest first
form,filing_date,report_date,accession_number,description,sec_url
10-K,2025-10-31,2025-09-27,0000320193-25-000079,10-K,https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.html
10-K,2024-11-01,2024-09-28,0000320193-24-000123,10-K,https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.html
10-K,2023-11-03,2023-09-30,0000320193-23-000106,10-K,https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/0000320193-23-000106-index.html
10-K,2022-10-28,2022-09-24,0000320193-22-000108,10-K,https://www.sec.gov/Archives/edgar/data/320193/000032019322000108/0000320193-22-000108-index.html
10-K,2021-10-29,2021-09-25,0000320193-21-000105,10-K,https://www.sec.gov/Archives/edgar/data/320193/000032019321000105/0000320193-21-000105-index.html
More: https://fundalyze.ai/stocks/nasdaq/aapl?tab=seclist_filings: response data
The same content as JSON (REST).
{
"ticker": "AAPL",
"cik": 320193,
"filings": [
{
"form": "10-K",
"filing_date": "2025-10-31",
"report_date": "2025-09-27",
"accession_number": "0000320193-25-000079",
"description": "10-K",
"sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/0000320193-25-000079-index.html"
},
{
"form": "10-K",
"filing_date": "2024-11-01",
"report_date": "2024-09-28",
"accession_number": "0000320193-24-000123",
"description": "10-K",
"sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.html"
},
{
"form": "10-K",
"filing_date": "2023-11-03",
"report_date": "2023-09-30",
"accession_number": "0000320193-23-000106",
"description": "10-K",
"sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/0000320193-23-000106-index.html"
},
{
"form": "10-K",
"filing_date": "2022-10-28",
"report_date": "2022-09-24",
"accession_number": "0000320193-22-000108",
"description": "10-K",
"sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019322000108/0000320193-22-000108-index.html"
},
{
"form": "10-K",
"filing_date": "2021-10-29",
"report_date": "2021-09-25",
"accession_number": "0000320193-21-000105",
"description": "10-K",
"sec_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019321000105/0000320193-21-000105-index.html"
}
]
}Fields of data
What each field of data means. rows[].field is a field of each row in the rows list.
| Field | Meaning |
|---|---|
ticker | The ticker as listed in the SEC EDGAR directory, upper case. |
cik | SEC Central Index Key, the company's permanent EDGAR id. |
filings | The company's SEC filings, newest first. |
filings[].form | SEC form type (10-K, 10-Q, 8-K, 4, DEF 14A...). |
filings[].filing_date | Date the filing was accepted by the SEC (ISO date). |
filings[].report_date | Period the filing reports on (ISO date), or null. |
filings[].accession_number | SEC accession number, the filing's unique id. |
filings[].description | The filing's description from the SEC index. |
filings[].sec_url | The filing's index page on sec.gov. |
The link
Every answer ends with More: <link>, and REST returns the same URL as link: the fundalyze.ai page where the figures can be checked (here, fundalyze.ai/stocks/nasdaq/aapl?tab=sec). Cite it when you show the data to others, as the attribution rules ask.
Errors
A bad parameter is a 400 naming it, an unknown ticker a 404, a busy key or a used-up day a 429. Every status and message: Errors.
This page as Markdown, for language models and scripts: /developers/md/reference/list_filings