Get filing
Reads one filing as its primary filer’s filings list shows it: its title line, where it stands in the store, the version it was extracted under and what that extraction produced, with its filers, the primary filer first, and the render its page images come from. A filing the store does not hold 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
Bearer token. Use ss_live_… for live data or ss_test_… for the sandbox (test mode). See Authentication.
Path parameters
The filing’s id: its SEC accession number, ten digits, two digits and six digits joined by hyphens.
Headers
Pin the API version, e.g. 2026-10-07. Omit to get the latest. See Versioning.
Response headers
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.
Request budget of the endpoint’s rate-limit policy per 60-second sliding window. See Rate limits.
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.
Seconds until a guaranteed-fresh window.
The active policy in limit;w=window-seconds form.
Response
The render the filing’s page images come from: the tag the html renderer stamped on the filing, else the extraction’s own version; null when the filing is not extracted.