Filings by Ticker
GET/v1/filings/{ticker}
List SEC EDGAR filings for a company by ticker. Optionally filter by form type (10-K, 10-Q, 8-K, etc.) using a comma-separated form parameter. Returns filing metadata - form, filing date, accession number and Vantafin filing id - with pagination via page and limit. Use the filing id with the Filing by ID endpoint or Vantafin’s filing viewer for full text.
Use cases
- Building a filing history tab on a company profile
- Finding the latest
10-Kor10-Qfor a ticker - Compliance workflows that track periodic reports
- Feeding filing ids into document search or download pipelines
Input parameters
Required
| Parameter | Type | Description |
|---|---|---|
| ticker(*) | string | Ticker. |
| form | string | Form filter, e.g. 10-K or 10-K,10-Q,8-K. |
| page | integer | Zero-based page (default 0). |
| limit | integer | Page size, 1-2000 (default 50). |
Output parameters
| Field | Type | Description |
|---|---|---|
| ticker | string | Ticker requested. |
| cik | string | Company CIK. |
| results | array | Filing metadata rows for this page. |
| results[].id | string | Vantafin filing id. |
| results[].form | string | SEC form type (e.g. 10-K, 10-Q). |
| results[].filedAt | string | Filing timestamp (ISO 8601). |
| results[].reportDate | string | Period of report (YYYY-MM-DD). |
| results[].accessionNumber | string | SEC accession number. |
| results[].primaryDocument | string | Primary document filename. |
| total | integer | Total filings matching the query. |
| page | integer | Zero-based page index. |
from vantafin import RESTClient
client = RESTClient("vf-live-your_api_key")
result = client.get_filings("AAPL", form="10-K,10-Q")
print(result){
"ticker": "AAPL",
"cik": "0000320193",
"results": [
{
"cik": "0000320193",
"ticker": "AAPL",
"company": "Apple Inc.",
"form": "10-Q",
"date": "2026-05-01T10:01:00Z",
"accession": "0000320193-26-000013",
"edgar_base": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000013",
"exhibits": [
{
"type": "10-Q",
"sequence": 1,
"filename": "aapl-20260328.htm",
"description": "10-Q",
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000013/aapl-20260328.htm",
"minio_key": "320193/000032019326000013/aapl-20260328.htm"
},
{
"type": "EX-31.1",
"sequence": 2,
"filename": "a10-qexhibit31103282026.htm",
"description": "EX-31.1",
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000013/a10-qexhibit31103282026.htm",
"minio_key": "320193/000032019326000013/a10-qexhibit31103282026.htm"
}
],
"id": "0000320193_000032019326000013"
},
{
"cik": "0000320193",
"ticker": "AAPL",
"company": "Apple Inc.",
"form": "10-Q",
"date": "2026-01-30T11:01:32Z",
"accession": "0000320193-26-000006",
"edgar_base": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000006",
"exhibits": [
{
"type": "10-Q",
"sequence": 1,
"filename": "aapl-20251227.htm",
"description": "10-Q",
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000006/aapl-20251227.htm",
"minio_key": "320193/000032019326000006/aapl-20251227.htm"
},
{
"type": "EX-31.1",
"sequence": 2,
"filename": "a10-qexhibit31112272025.htm",
"description": "EX-31.1",
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000006/a10-qexhibit31112272025.htm",
"minio_key": "320193/000032019326000006/a10-qexhibit31112272025.htm"
}
],
"id": "0000320193_000032019326000006"
}
],
"total": 26,
"page": 0
}