SEC filings API

The filings endpoint returns the SEC EDGAR filing index for a ticker: form type (10-K, 10-Q, 8-K, Form 4, DEF 14A, S-1 and their amendments), filing date, EDGAR accession number and a link to the document on sec.gov. 8-K rows carry the item codes the filer selected, such as 2.02 for results of operations.

The index is read from SEC EDGAR and refreshed nightly, with 8-K and Form 4 arrivals picked up every 15 minutes during US weekdays. Financial statement values from the same 10-K and 10-Q filings are served by the fundamentals endpoints, and every computed surface covers US domestic filers; foreign private issuers filing 20-F or 40-F are excluded from them.

List recent 10-K filings for a ticker

curl
curl -s "https://api.distillmarkets.com/api/v1/sec/filings/AAPL?filingType=10-K&limit=3" \
  -H "X-Api-Key: $DISTILL_API_KEY"
python (requests)
import os
import requests
 
HEADERS = {"X-Api-Key": os.environ["DISTILL_API_KEY"]}
BASE = "https://api.distillmarkets.com"
 
r = requests.get(
    f"{BASE}/api/v1/sec/filings/AAPL",
    params={"filingType": "10-K", "limit": 3},
    headers=HEADERS,
    timeout=30,
)
r.raise_for_status()
for filing in r.json():
    print(filing["filedAt"], filing["filingType"], filing["accessionNumber"])

Sample response

GET /api/v1/sec/filings/AAPL?filingType=10-K&limit=3
[
  {
    "ticker": "AAPL",
    "filingType": "10-K",
    "formDescription": "<string>",
    "filedAt": "<YYYY-MM-DD>",
    "accessionNumber": "<EDGAR accession>",
    "cikNumber": "<10-digit CIK>",
    "url": "<sec.gov document URL>",
    "items": ["<item code>", "..."]
  }
]
Shape only. This endpoint needs an API key, so no response was captured for it. Field names come from the endpoint reference; <...> marks a value that varies.

Limits

Related