Skip to content

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

Parameters

Accession number: the SEC's ID for a filing, such as 0001829126-26-010431. The dashes are optional.

Without a key the API answers 401; you can still send the request to see that.
Python
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

NameInTypeRequiredDefaultDescription
accessionpathstringyesAccession number: the SEC's ID for a filing, such as 0001829126-26-010431. The dashes are optional.

Responses

StatusBodyDescription
200binary (application/pdf)The PDF. Headers: Content-Disposition, ETag, X-Pdf-Cache, X-Pdf-Documents.
304noneNot modified (If-None-Match matched the ETag).
400Problem (application/problem+json)Invalid or unknown parameter.
401Problem (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).
404Problem (application/problem+json)Not found.
422Problem (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.
429Problem (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).
503Problem (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.
defaultProblem (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

Python
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