GET /v3/filings/{accession}/pdf
Render a whole filing as one PDF.
The primary document comes first, then every other HTML or text document in sequence order. XBRL files (EX-101.*), EDGAR's generated viewer pages (R1.htm, FilingSummary.xml) and binary files are left out. Images appear where the documents show them. X-Pdf-Documents lists the sequence numbers included, in order. Everything else works as for one document's PDF.
API key: required. See Authentication.
Group: Filings
Try it
Without a key the API answers 401; you can still send the request to see that.
import os
import requests
r = requests.get(
"https://api.secblast.com/v3/filings/0001829126-26-010431/pdf",
headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())Response
Nothing has been sent yet.
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
accession | path | string | yes | Accession number: the SEC's ID for a filing, such as 0001829126-26-010431. The dashes are optional. |
Responses
| Status | Body | Description |
|---|---|---|
200 | binary (application/pdf) | The PDF. Headers: Content-Disposition, ETag, X-Pdf-Cache, X-Pdf-Documents. |
304 | none | Not modified (If-None-Match matched the ETag). |
400 | Problem (application/problem+json) | Invalid or unknown parameter. |
401 | Problem (application/problem+json) | Missing, invalid, or inactive API key (code unauthorized), or a refused access token (code invalid_token: malformed, unknown key, bad signature, expired, wrong issuer or audience, revoked grant). WWW-Authenticate names the protected-resource metadata (RFC 9728). |
404 | Problem (application/problem+json) | Not found. |
422 | Problem (application/problem+json) | not_renderable: the document is not HTML, text, XML, or JSON (an image, PDF, ZIP, or spreadsheet; member document: its URL), or the filing has no such document; pdf_failed (member reason render_timeout, render_failed, or output_too_large): the renderer could not render it within its limits (the same request is refused for about 10 minutes); document_too_large (members document_bytes and limit): larger than the renderer takes. |
429 | Problem (application/problem+json) | The credential's organization (its key, for a legacy key) already has 3 PDF renders in progress (code rate_limited, reason pdf_concurrency, Retry-After: 2); or the plan's rate or quota limits (code rate_limited / quota_exceeded). |
503 | Problem (application/problem+json) | pdf_rendering (Retry-After): the PDF was not finished within the request's time; it goes on, and the same request after the delay is answered from the cache. pdf_busy (Retry-After): the renderer's queue is full. pdf_unavailable: the renderer cannot be reached (Retry-After) or this server has none; or db_unavailable. |
default | Problem (application/problem+json) | Any other error (405, 500, 504). |
Response body
A 200 carries the stored bytes, with the content type of the document.
Example request
import os
import requests
r = requests.get(
"https://api.secblast.com/v3/filings/0001829126-26-010431/pdf",
headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())More in Filings
Previous: GET /v3/filings/{accession}/header · Next: GET /v3/filings/{accession}/versions
Markdown version: /docs/reference/get-filings-accession-pdf.md