API · Filings
Resolve a filing page snapshot
Turn a page_id into a citable URL — PNG for Nordic, EDGAR link for US.
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
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
}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"
}