Skip to navigation

List registrant documents

Lists the store documents a registrant’s annual or quarterly sheet reads, each with the fields of the filing it came with: the filings the store extracted and nothing has superseded, of the forms named in forms, from from_year on. An annual sheet reads the 10-K; a quarterly sheet reads the 10-Q, the 10-K and the 8-K. By filing date, then each filing’s documents in order; not paged. 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

registrant_idstringRequired

The registrant’s id: its SEC CIK, one to ten digits, with or without its leading zeros.

Headers

SpreadSpace-VersionstringOptionalformat: "^\d{4}-\d{2}-\d{2}$"

Pin the API version, e.g. 2026-10-07. Omit to get the latest. See Versioning.

Query parameters

sheetstringOptional

The sheet the documents are for: annual or quarterly; annual when absent.

formslist of stringsOptional

The forms to read, one forms query parameter per form, among 10-K, 10-Q, 8-K and S-1 in any case, an amendment read with its base form; the sheet’s forms when absent.

from_yearintegerOptional
The first year to read, 1993 to 2100. Omit for every year the store holds.

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

OK
datalist of objects
has_moreboolean
next_cursorstring or nullOptional

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error