Get IPOs saved search results
Returns the IPOs matching a saved IPOs search.
What you need
An IPOs saved-search ID shared with the API; get one from Get all saved searches, or check counts first with Get IPOs saved search.
Behaviour
- Each item is the same IPO object Get IPOs by date returns, so it parses identically.
- The saved search must be shared with the API (via “Share to API”) or be a global search curated by Specter.
- Set
new_results_afterto a timestamp to return only the listings added to the search since then — pass back the timestamp of your last read to poll for what is new. It must be within the last 60 days. - Must be a IPOs search, otherwise
400withNOT_SUPPORTED_PRODUCT. searchIdmust be a number, otherwise400(BAD_SEARCH_ID_TYPE); returns404if the search doesn’t exist.- A search that matches nothing returns
200with an empty array, and is not charged.
What you do next
- Get the full company. Follow a
company_idto Get company by ID for the complete profile. - Open a single IPO. Pass an IPO ID to Get IPO by ID.
Authorizations
Path Parameters
The ID of the saved search being requested.
Query Parameters
Only return records added to the search on or after this moment, e.g. 2026-07-10T00:00:00Z. Must be within the last 60 days.
The number of results to return per page (minimum 1, maximum 5000, default 50).
1 <= x <= 5000The page number of results to return, base 0, default is 0.
Response
A page of IPOs.
The Specter ID for this IPO. Stable across deliveries and usable on GET /ipos/{ipo_id}.
"ipo_dff0947b71f841d30d9d083c"
The Specter company ID of the issuing company. Use with Get company by ID to fetch the full company record.
"5fc743c1bf7e53924df4359d"
The issuing company's name.
"Hamilton Beach Brands Inc."
The issuing company's primary domain, if known.
"hamiltonbeachbrands.com"
The exchange the company listed on (lowercase, e.g. nasdaq, nyse).
"nyse"
Ticker symbol of the company.
"HBB"
Date the company went public (YYYY-MM-DD).
"2017-09-29"
Initial offering share price in USD.
22
Implied valuation at listing in USD.
1192737304
Total proceeds from the offering in USD.
101200000