Download file from SEC EDGAR archive

Downloads a specific file from the SEC EDGAR archive using the accession number and filename. The file is streamed directly from the SEC servers to the client.

Accession Number Format

Accession numbers must be in the format: 0000000000-00-000000 (10 digits, dash, 2 digits, dash, 6 digits)

File Name Examples

Primary documents: d123456d10k.htm, d789012d8k.htm
XBRL files: d123456d10k_htm.xml, FilingSummary.xml
Exhibits: d123456dexhibit99.htm, d123456dex101.htm

File Types

The endpoint supports downloading various file types from SEC filings:

HTML documents (.htm, .html)
XBRL files (.xml, .xsd)
Text files (.txt)
PDF files (.pdf)
Other document formats as submitted to SEC

You can find available filenames for a specific filing using the /v1/filings endpoint first

This endpoint streams files directly from the SEC. Large files may take longer to download.

Authorization

Authorization<token>

API Key is required to access the endpoints

In: header

Query Parameters

accession_no*string

SEC filing accession number in format: 0000000000-00-000000

Match^\d{10}-\d{2}-\d{6}$

file_name*string

Name of the file to download from the filing

Response Body

curl -X GET "https://api.sec.finfeedapi.com/v1/download?accession_no=string&file_name=string"

Empty

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  },
  "property1": null,
  "property2": null
}

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Service Status GitHub SDK