Filing by ID
GET/v1/filings/by-id/{filing_id}
Fetch metadata for a single SEC filing using its Vantafin filing id (from the Filings by Ticker list or search). Returns form type, filing and report dates, CIK, ticker, primary document and URLs to the archived filing. Use this when you already have a filing id and need canonical metadata before pulling chunked content or linking to the EDGAR source.
Use cases
- Deep-linking to a specific filing from search results
- Hydrating filing cards in a research UI
- Pipeline steps that resolve id → metadata before text extraction
- Audit trails that reference a stable Vantafin filing id
Input parameters
Required
| Parameter | Type | Description |
|---|---|---|
| filing_id(*) | string | Vantafin filing id. |
Output parameters
| Field | Type | Description |
|---|---|---|
| id | string | Vantafin filing id. |
| form | string | SEC form type. |
| filedAt | string | Filing timestamp (ISO 8601). |
| reportDate | string | Period of report (YYYY-MM-DD). |
| accessionNumber | string | SEC accession number. |
| cik | string | Company CIK. |
| ticker | string | Ticker. |
| primaryDocument | string | Primary document filename. |
| url | string | URL to the filing on SEC EDGAR. |
from vantafin import RESTClient
client = RESTClient("vf-live-your_api_key")
result = client.get_filing("0000320193-24-000123")
print(result){
"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"
}