Get registrant
Reads one registrant: its name, tickers and exchanges, industry classification, state and fiscal year end, how many filings the store holds for it and its newest filing date, with latest_period, the newest period end among its extracted filings that nothing has superseded. The registrant’s id is its SEC CIK, with or without leading zeros; it needs an active Market research subscription and markets:read, and the filings are listed by GET /api/public/registrants/{registrant_id}/filings.
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 registrant’s id: its SEC CIK, one to ten digits, with or without its leading zeros.
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 newest period end among the registrant’s extracted filings that nothing has superseded; null when none.