Search registrants
Searches the public filings store’s registrants by ticker, name or CIK: an exact ticker first, then a name that starts with the text, then one that contains it, then a CIK with or without its leading zeros; ties by how many filings the store holds, then by name. Answers the list envelope with the best matches in data, at most limit of them. The search is not paged (has_more is false and next_cursor null): narrow the text to see other matches. Needs an active 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.
Headers
Pin the API version, e.g. 2026-10-07. Omit to get the latest. See Versioning.
Query parameters
The text to search: a ticker, part of a name, or a CIK. Required; at most 200 characters.
The most registrants to return, 1 to 100; 50 when absent.
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.