Docs / API reference

GET /v1/download

Fetch a filing's document straight from the EDGAR archive, through Edgrapi's politeness gate, circuit breaker and week-long cache, so you never hit SEC.gov directly or manage the User-Agent and rate limits. Omit file for the primary document; pass it to pull a specific exhibit.

Parameters

ParamInValues
accessionqueryRequired. Accession number, e.g. 0000320193-24-000123
filequeryDocument filename within the filing. Omit for the primary document (the 10-K, 8-K, Form 4, etc.)
cikqueryFiler CIK. Omit to derive it from the accession

Request

# primary document of a filing
curl "https://api.edgrapi.com/v1/download?accession=0000320193-24-000123" -H "X-API-Key: edgr_..."

# a specific exhibit by filename
curl "https://api.edgrapi.com/v1/download?accession=0000320193-24-000123&file=exhibit99.htm" -H "X-API-Key: edgr_..."

Response

The document is returned with its own content type (text/html, application/xml, or text/plain) and a Content-Disposition header, not wrapped in JSON. The X-SEC-Source response header carries the original SEC.gov URL.

Text documents only (HTML, XML, TXT) — the primary documents and text exhibits. Binary exhibits like images and embedded PDFs are not proxied; their SEC.gov URL is in the /v1/filings response. For clean, parsed narrative text built for LLM/RAG, use /v1/sections instead of the raw document.

Cost: 1 credit. A missing document refunds (404 is free).

← Form 144Form D →