Path Parameters
| Name | Type | Example | Description |
|---|---|---|---|
| symbol | string | AAPL | Ticker symbol. |
Query Parameters
| Name | Type | Example | Description |
|---|---|---|---|
| form_type | string | 10-K | SEC Filing form type |
| start_date | string | 2024-01-01 | Start date for the filing data |
| end_date | string | 2026-12-31 | End date for the filing data |
Auth
headers: { 'Authorization': 'Replace with your API token' }
Examples
fetch('https://api.gurufocus.com/data/stocks/AAPL/filings?form_type=10-K&start_date=2024-01-01&end_date=2026-12-31', { method: 'GET', headers: { 'Authorization': 'Replace with your API token' }})
Responses
Successful response. The exact payload fields depend on this endpoint.
Example Body (Field Reference)
[ { "accession_number": "0000320193-25-000079", "cik": "0000320193", "form_type": "10-K", "filing_date": "2025-10-31", "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000079/aapl-20250927.htm" }, { "accession_number": "0000320193-24-000123", "cik": "0000320193", "form_type": "10-K", "filing_date": "2024-11-01", "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/aapl-20240928.htm" }, { "accession_number": "0000320193-23-000106", "cik": "0000320193", "form_type": "10-K", "filing_date": "2023-11-03", "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019323000106/aapl-20230930.htm" }]
Introduction
The GuruFocus Filings Dataset provides structured access to SEC filing history for a given stock, making it easier to monitor disclosure events, build compliance workflows, and link regulatory documents to company research.
Use the form_type filter to narrow results to a specific filing class, and combine it with start_date and end_date to focus on the reporting window you need.
What’s Included
The Filings Dataset returns normalized filing records with:
- Accession Number
The SEC accession number for each filing record. - CIK
The SEC Central Index Key associated with the issuer. - Form Type
The filing form, such as10-K,10-Q, or other SEC disclosure types. - Filing Date
The date the filing was submitted. - Filing URL
The source URL to the filing document on EDGAR.
Data Coverage
This dataset is designed for U.S. listed equities with SEC filing coverage. Availability depends on issuer disclosure history and the selected form type.
Use Cases
This dataset is ideal for:
- Investment platforms tracking earnings releases, annual reports, and regulatory events
- Compliance teams monitoring issuer disclosures by form type and date range
- Research tools linking SEC filings to stock pages and company timelines
- Data teams building document search, alerting, or ingestion workflows
Extend Your Capabilities
Combine the Filings Dataset with other GuruFocus data offerings:
- Profile Dataset - Core company identity and valuation metrics
- Fundamental Dataset - Historical financial statements and cash flow data
- News Dataset - Timely commentary and market context around filing events
All datasets follow a consistent structure and are accessible through unified API endpoints.
Response Reference
| Display Name | Field Name | Data Type |
|---|---|---|
| Accession Number | accession_number | string |
| CIK | cik | string |
| Form Type | form_type | string |
| Filing Date | filing_date | date |
| Filing URL | filing_url | url |