Home / Products / File access
File access

Filing Download API: every EDGAR document and exhibit as filed

List every file in an SEC filing and download any document, exhibit, XBRL file or image from the EDGAR archive with one authenticated call.

Get free API keyRead the docs
curl -H "Authorization: Bearer $SECFEED_KEY" \
  "https://secfeedapi.com/v1/files?cik=320193&accessionNo=0000320193-26-000020"
import os, requests

r = requests.get(
    "https://secfeedapi.com/v1/files",
    params={'cik': '320193', 'accessionNo': '0000320193-26-000020'},
    headers={"Authorization": f"Bearer {os.environ['SECFEED_KEY']}"},
)
print(r.json())

Overview

Every EDGAR filing is a folder of files: the main document, exhibits, XBRL instance and linkbases, images and the full text submission. The Download API lists them for any accession number and returns any one of them exactly as filed.

SecFeed handles the SEC's fair access rules for you (User-Agent, rate limits, retries), so your code never gets blocked for hammering sec.gov. Inline XBRL viewer links (/ix?doc=) are resolved to the underlying document automatically.

What you get

Built for developers who would rather not parse EDGAR.

File list per filing

Name, type, size and URL of every file in a filing, from the EDGAR directory index.

Any archive file

HTML, TXT, XML, XBRL, JPG, PDF: returned byte for byte as filed with the right content type.

No SEC rate limit headaches

Requests go through SecFeed's throttled, identified client and cache.

iXBRL links work

Viewer URLs like sec.gov/ix?doc=... are converted to the archive document.

Endpoints

Authenticate with Authorization: Bearer YOUR_KEY. Responses are JSON.

GET/v1/filesDocs →

Every file in a filing: documents, exhibits, XBRL, images.

Parameters: cik, accessionNo

GET/v1/downloadDocs →

Any EDGAR archive file as filed.

Parameters: url

Response fields

The main fields in every result. The raw filing data is always one level down.

FieldMeaning
nameFile name inside the filing folder.
typeEDGAR's icon type for the file (text, compressed, image).
sizeSize in bytes, when EDGAR reports it.
urlArchive URL to pass to /v1/download or /v1/pdf.

Use cases

Datasets behind this API

The SEC forms this API reads, with live filing counts.

10-KAnnual reports

Every Form 10-K annual report filed on EDGAR since 1993, searchable by company, date and text, with sections and XBRL financials as JSON.

10-QQuarterly reports

Every Form 10-Q quarterly report on EDGAR since 1993: unaudited financials, MD&A and risk factor updates, searchable and parsed as JSON.

8-KCurrent reports

Every Form 8-K current report since 1993, classified by item: earnings, acquisitions, auditor changes, executive departures, cyber incidents and more.

Ex 99Press releases + Reg FD

Press releases, investor presentations and Regulation FD materials attached to 8-K filings as Exhibit 99, searchable in full text.

Ex 10Material contracts

Material contracts filed as Exhibit 10 to 8-K, 10-K and 10-Q reports: credit agreements, employment agreements, leases and supply deals.

Tutorials

Fetch & downloadDownload SEC filings and exhibits from EDGAR

List every file in an SEC filing and download any document or exhibit, such as Exhibit 21 subsidiaries, with two API calls.

FAQ

Which URLs can I download?

Any file under https://www.sec.gov/Archives/edgar/data/. Pass it as url to /v1/download.

How do I find the URL of an exhibit?

Call /v1/files with the CIK and accession number. It lists every file in the filing with its URL.

Try the Download Filings & Exhibits free

500 API calls a month on the free plan. No sales call.

Get free API key →