Download file from SEC EDGAR archive
GET/v1/download
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.
Request
Query Parameters
Possible values: Value must match regular expression ^\d{10}-\d{2}-\d{6}$
SEC filing accession number in format: 0000000000-00-000000
Name of the file to download from the filing
Responses
- 200
- 400
- 404
- 500
File downloaded successfully
- application/octet-stream
- text/html
- application/xml
- text/plain
- application/pdf
- Schema
Schema
any
- Schema
Schema
any
- Schema
Schema
any
- Schema
Schema
any
- Schema
Schema
any
Invalid request parameters
- application/octet-stream
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
errors
object
nullable
property name*
string[]
nullable
string
{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"errors": {}
}
- Schema
- Example (from schema)
Schema
Array [
]
errors
object
nullable
property name*
string[]
nullable
string
{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"errors": {}
}
Filing or file not found
- application/octet-stream
- application/json
- Schema
- Example (from schema)
Schema
{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string"
}
- Schema
- Example (from schema)
Schema
{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string"
}
Server error
- application/octet-stream
- application/json
- Schema
- Example (from schema)
Schema
{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string"
}
- Schema
- Example (from schema)
Schema
{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string"
}