Get filing document pages

GET

https://api.spreadspace.app/api/public/filings/:filing_id/documents/:document_id/pages

GET

/api/public/filings/:filing_id/documents/:document_id/pages

curl -G https://api.spreadspace.app/api/public/filings/0009900077-26-000012/documents/d0c0000000000000000000b5/pages \
     -H "SpreadSpace-Version: 2026-10-07" \
     -H "Authorization: Bearer <token>" \
     -d variant=original

{
  "accession": "0009900077-26-000012",
  "document_id": "d0c0000000000000000000b5",
  "render_version": "r7",
  "available_variants": [
    "original"
  ],
  "pages": [
    {
      "index": 0,
      "width_pts": 612,
      "height_pts": 792,
      "url": "https://filings.example/public-artifacts/0009900077-26-000012/r7/d0c0000000000000000000b5/page_001.webp?X-Amz-Expires=600"
    },
    {
      "index": 1,
      "width_pts": 612,
      "height_pts": 792,
      "url": "https://filings.example/public-artifacts/0009900077-26-000012/r7/d0c0000000000000000000b5/page_002.webp?X-Amz-Expires=600"
    }
  ],
  "expires_in": 600
}

Returns a filing document’s page images: the pages rendered from the filing’s own PDF, in order, each with its size in PDF points and a link good for expires_in seconds (ask again for fresh links). The first ask for a document starts its render and answers 202 with status rendering; ask again in a few seconds until the pages answer. A filing or document the store does not hold, a document of an older extraction, or one with no rendered PDF is 404. Needs a Market research subscription and markets:read.

Requires the markets:read scope. Rate limit: 200 requests per minute per key (the api lane).

Authentication

AuthorizationBearer

Bearer token. Use ss_live_… for live data or ss_test_… for the sandbox (test mode). See Authentication.

Path parameters

filing_idstringRequired

The filing’s id: its SEC accession number.

document_idstringRequired

The document's id, from the company's documents list.

Query parameters

variantstringOptional

The page set: original, the only one a filing holds; absent reads as original.

Response headers

X-Request-IDstringOptional

Correlation ID for this request. Quote it in support tickets.

SpreadSpace-VersionstringOptional

The API surface version the server resolved for this request. Always present, regardless of whether the client supplied the request-side SpreadSpace-Version header. Default: 2026-10-07.

RateLimit-Limitinteger

Request budget of the endpoint’s rate-limit policy per 60-second sliding window. See Rate limits.

RateLimit-Remaininginteger

Requests left in the current window. Suppressed on 429 responses produced outside the rate limiter (for example a usage throttle), where a remaining budget would be misleading.

RateLimit-Resetinteger

Seconds until a guaranteed-fresh window.

RateLimit-PolicystringOptional

The active policy in limit;w=window-seconds form.

Response

accessionstring

The filing's SEC accession number.

document_idstring

The document's id in the store.

render_versionstring

The render the pages come from; a new render lands under a new one.

available_variantslist of strings

The page sets the render holds; original today.

pageslist of objects

The pages in order, each with its size in PDF points and its link.

expires_ininteger

How long the links stay valid, in seconds; ask again for fresh ones.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error