API · Filings

Resolve a filing page snapshot

Turn a page_id into a citable URL — rendered PNG, EDGAR link, or ESEF viewer link.

GET/api/v1/data/filings/{page_id}/snapshot

page_ids are returned by other endpoints alongside any figure or passage that has a filing-level source. Pass that id here and you get back a viewable URL plus the surrounding metadata (company_name, year, document_type, page_number).

See Page IDs and citations for the full lifecycle including stable-CDN vs. presigned-S3 URLs and caching guidance.

When to use this

Whenever you render a number or quote to a user. A clickable "see source" link transforms a generic financial product into one auditors and CFOs trust.

Path

Field	Type	Description
page_idrequired	string	Page identifier returned in pdf_info or content-search results.

Query

Field	Type	Description
dpi	integer default: 150	Render resolution for Nordic PNG snapshots (72–300).

Example

bash

curl "https://api.clarifo.com/api/v1/data/filings/722df34e9f191a97_20/snapshot?dpi=200" \
  -H "Authorization: Bearer $CLARIFO_API_KEY"

Response shapes

The kind field determines what snapshot_url points to:

Kind	Description
`rendered_png`	Per-page PNG render of the original PDF filing.
`edgar_link`	SEC EDGAR viewer link for US filings.
`viewer_link`	ESEF inline XBRL viewer link for Nordic filings.

Nordic — rendered_png

{
"page_id": "722df34e9f191a97_20",
"available": true,
"kind": "rendered_png",
"snapshot_url": "https://cdn.clarifo.com/snapshots/…/p20.png",
"company_name": "Neste Oyj",
"year": "2024",
"document_type": "annual_report",
"page_number": 20,
"dpi": 200,
"citation_label": "Neste Oyj 2024, p. 20",
"citation_markdown": "[Neste Oyj 2024, p. 20](https://cdn.clarifo.com/snapshots/…/p20.png)"
}

US — edgar_link

{
"page_id": "0000320193-25-000079",
"available": true,
"kind": "edgar_link",
"snapshot_url": "https://www.sec.gov/Archives/edgar/data/…",
"company_name": "Apple Inc.",
"year": "2025",
"document_type": "10-K",
"citation_label": "Apple Inc. 10-K 2025",
"citation_markdown": "[Apple Inc. 10-K 2025](https://www.sec.gov/Archives/edgar/data/…)"
}

Not available

{
"page_id": "abc",
"available": false,
"kind": null,
"snapshot_url": null,
"reason": "Page rendering pending"
}

Citation fields

citation_label and citation_markdown are pre-formatted strings ready to embed in a UI or document. Use citation_markdown directly when rendering Markdown -- it includes the hyperlink to the source.