PDF

GET /v2/pdfTry it in Playground →

Generate PDF from SEC filing documents. Provide either a single document_id or an accession_number to combine all HTML documents with a professional cover page.

Parameters

Parameter	Type	Description
`api_key`	string	Required. Your API key.
`document_id`	string	Single document ID to convert to PDF.
`accession_number`	string	Accession number to combine all HTML documents into one PDF.

Note: Provide either document_id or accession_number, not both.

Output Features

Single Document PDF

Header with company name and form type
Footer with accession number and page numbers
Professional margins and formatting

Accession PDF (Combined)

Cover page with filing entity information
Table of contents with page numbers
All HTML documents combined in sequence
Headers and footers throughout
Reporting period and filing date displayed

Examples

Single Document PDF

curl "https://api.secblast.com/v2/pdf?api_key=YOUR_KEY&document_id=0000320193-24-000081-1" \
  --output filing.pdf

Full Filing PDF

curl "https://api.secblast.com/v2/pdf?api_key=YOUR_KEY&accession_number=0000320193-24-000081" \
  --output full_filing.pdf

Using JSON Body

curl -X GET "https://api.secblast.com/v2/pdf" \
  -H "Content-Type: application/json" \
  -d '{"api_key": "YOUR_KEY", "accession_number": "0000320193-24-000081"}' \
  --output filing.pdf

Response

Returns binary PDF data with Content-Type: application/pdf header.

HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="0000320193-24-000081.pdf"

%PDF-1.4
...binary PDF data...

Cover Page Contents

When using accession_number, the cover page includes:

Company name and CIK
Form type (10-K, 10-Q, 8-K, etc.)
Filing date and reporting period
SIC code and industry description
State of incorporation and business location
Fiscal year end
Filer category (Large accelerated filer, etc.)
Table of contents with document descriptions and page numbers

Errors

Errors are returned as JSON with an error field. See the error codes reference for the full list.

400Missing or invalid parameters

{
  "error": "Either document_id or accession_number is required"
}

401Invalid or missing API key

{
  "error": "Invalid or missing API key"
}

429Monthly request or bandwidth limit exceeded

{
  "error": "Monthly request limit exceeded. Upgrade your plan at https://secblastapi.com/pricing"
}