--- title: "Get IPO filings" method: GET path: "/ipos" tags: ["IPOs"] --- # Get IPO filings `GET /ipos` Get SEC registration statements (Form S-1 and S-1/A), newest filings first. Every filing is classified (ipo, shell_company, spac, resale, or other) with structured cover-page metadata: proposed ticker, exchange, and expected offering price or price range. For IPO-grade filings whose financial statements have been extracted, the item embeds full income statements, balance sheets, and cash flow statements under financials, in the same shape as the /financials endpoints. No parameters are required: by default the latest filings across all companies are returned. ## Query parameters - `ticker` string - `cik` string - `classification` 'ipo' | 'shell_company' | 'spac' | 'resale' | 'other' - `filing_date` string, date - `filing_date_gte` string, date - `filing_date_lte` string, date - `filing_date_gt` string, date - `filing_date_lt` string, date - `limit` integer ## Response `200` IPOs response - IposResponse - `ipos` Ipo[] - `accession_number` string — The unique SEC accession number of the filing. - `cik` string — The SEC Central Index Key of the filer, zero-padded to 10 digits. - `form_type` 'S-1' | 'S-1/A' — The SEC form type: S-1 (initial registration statement) or S-1/A (amendment). - `company_name` string, nullable — The name of the filing company. - `filing_date` string, date, nullable — The date the filing was submitted to the SEC. - `accepted_datetime` string, date-time, nullable — The exact timestamp the SEC accepted the filing. - `filing_url` string, nullable — The URL of the filing on SEC EDGAR. - `classification` 'ipo' | 'shell_company' | 'spac' | 'resale' | 'other', nullable — The filing classification: ipo (a real operating company registering to list on an exchange), shell_company, spac, resale, or other. - `is_ipo_grade` boolean, nullable — Whether the filing is a real operating company going public: an underwritten primary offering with an exchange listing. - `ticker` string, nullable — The proposed ticker symbol from the filing's cover page. - `exchange` string, nullable — The exchange the company intends to list on. - `expected_offering_price` number, nullable — The expected offering price per share from the cover page, when a single price is stated. - `price_range_low` number, nullable — The low end of the expected offering price range, when a range is stated. - `price_range_high` number, nullable — The high end of the expected offering price range, when a range is stated. - `has_financial_statements` boolean, nullable — Whether the filing contains financial statements. - `has_price_on_cover` boolean, nullable — Whether the cover page states an offering price or price range. - `status` 'PENDING' | 'SKIPPED' | 'EXTRACTING' | 'COMPLETED' | 'FAILED' — The processing state of the filing. A filing appears on the feed as soon as it is classified; financials are populated when status is COMPLETED. - `financials` object, nullable — The full pre-IPO financial statements extracted from the prospectus, in the same shape as the /financials endpoints. Null unless status is COMPLETED. - `income_statements` IncomeStatement[] - `ticker` string — The ticker symbol. - `report_period` string, date — The reporting period of the income statement. - `fiscal_period` string — The fiscal period of the income statement. - `period` 'quarterly' | 'ttm' | 'annual' — The time period of the income statement. - `currency` string — The currency in which the financial data is reported. - `accession_number` string, nullable — The SEC accession number of the filing. - `filing_url` string, uri, nullable — URL to the SEC filing. - `filing_date` string, date, nullable — Calendar day SEC accepted the filing, in Eastern Time (the SEC's operating timezone). Calendar-day pair to `filing_datetime`. Null when no dated SEC filing is linked to the row. - `filing_datetime` string, date-time, nullable — Sub-day timestamp recording when SEC accepted the filing, in Eastern Time. Sourced from SEC's `acceptanceDateTime` field on the EDGAR submissions API. Pairs with `filing_date` (calendar-day precision of the same event). - `revenue` number — The total revenue of the company. - `cost_of_revenue` number — The cost of revenue of the company. - `gross_profit` number — The gross profit of the company. - `operating_expense` number — The operating expenses of the company. - `selling_general_and_administrative_expenses` number — The selling, general, and administrative expenses of the company. - `research_and_development` number — The research and development expenses of the company. - `operating_income` number — The operating income of the company. - `interest_expense` number — The interest expenses of the company. - `ebit` number — The earnings before interest and taxes of the company. - `income_tax_expense` number — The income tax expenses of the company. - `net_income_discontinued_operations` number — The net income from discontinued operations of the company. - `net_income_non_controlling_interests` number — The net income from non-controlling interests of the company. - `net_income` number — The net income of the company. - `net_income_common_stock` number — The net income available to common stockholders of the company. - `preferred_dividends_impact` number — The impact of preferred dividends on the net income of the company. - `consolidated_income` number — The consolidated income of the company. - `earnings_per_share` number — The earnings per share of the company. - `earnings_per_share_diluted` number — The diluted earnings per share of the company. - `dividends_per_common_share` number — The dividends per common share of the company. - `weighted_average_shares` number — The weighted average shares of the company. - `weighted_average_shares_diluted` number — The diluted weighted average shares of the company. - `balance_sheets` BalanceSheet[] - `ticker` string — The ticker symbol. - `report_period` string, date — The reporting period of the balance sheet. - `fiscal_period` string — The fiscal period of the balance sheet. - `period` 'quarterly' | 'ttm' | 'annual' — The time period of the balance sheet. - `currency` string — The currency in which the financial data is reported. - `accession_number` string, nullable — The SEC accession number of the filing. - `filing_url` string, uri, nullable — URL to the SEC filing. - `filing_date` string, date, nullable — Calendar day SEC accepted the filing, in Eastern Time (the SEC's operating timezone). Calendar-day pair to `filing_datetime`. Null when no dated SEC filing is linked to the row. - `filing_datetime` string, date-time, nullable — Sub-day timestamp recording when SEC accepted the filing, in Eastern Time. Sourced from SEC's `acceptanceDateTime` field on the EDGAR submissions API. Pairs with `filing_date` (calendar-day precision of the same event). - `total_assets` number — The total assets of the company. - `current_assets` number — The current assets of the company. - `cash_and_equivalents` number — The cash and equivalents of the company. - `inventory` number — The inventory of the company. - `current_investments` number — The current investments of the company. - `trade_and_non_trade_receivables` number — The trade and non-trade receivables of the company. - `non_current_assets` number — The non-current assets of the company. - `property_plant_and_equipment` number — The property, plant, and equipment of the company. - `goodwill_and_intangible_assets` number — The goodwill and intangible assets of the company. - `investments` number — The investments of the company. - `non_current_investments` number — The non-current investments of the company. - `outstanding_shares` number — The outstanding shares of the company. - `tax_assets` number — The tax assets of the company. - `total_liabilities` number — The total liabilities of the company. - `current_liabilities` number — The current liabilities of the company. - `current_debt` number — The current debt of the company. - `trade_and_non_trade_payables` number — The trade and non-trade payables of the company. - `deferred_revenue` number — The deferred revenue of the company. - `deposit_liabilities` number — The deposit liabilities of the company. - `non_current_liabilities` number — The non-current liabilities of the company. - `non_current_debt` number — The non-current debt of the company. - `tax_liabilities` number — The tax liabilities of the company. - `shareholders_equity` number — The shareholders' equity of the company. - `retained_earnings` number — The retained earnings of the company. - `accumulated_other_comprehensive_income` number — The accumulated other comprehensive income of the company. - `total_debt` number — The total debt of the company. - `cash_flow_statements` CashFlowStatement[] - `ticker` string — The ticker symbol. - `report_period` string, date — The reporting period of the cash flow statement. - `fiscal_period` string — The fiscal period of the cash flow statement. - `period` 'quarterly' | 'ttm' | 'annual' — The time period of the cash flow statement. - `currency` string — The currency in which the financial data is reported. - `accession_number` string, nullable — The SEC accession number of the filing. - `filing_url` string, uri, nullable — URL to the SEC filing. - `filing_date` string, date, nullable — Calendar day SEC accepted the filing, in Eastern Time (the SEC's operating timezone). Calendar-day pair to `filing_datetime`. Null when no dated SEC filing is linked to the row. - `filing_datetime` string, date-time, nullable — Sub-day timestamp recording when SEC accepted the filing, in Eastern Time. Sourced from SEC's `acceptanceDateTime` field on the EDGAR submissions API. Pairs with `filing_date` (calendar-day precision of the same event). - `net_income` number — The net income of the company. - `depreciation_and_amortization` number — The depreciation and amortization of the company. - `share_based_compensation` number — The share-based compensation of the company. - `net_cash_flow_from_operations` number — The net cash flow from operations of the company. - `capital_expenditure` number — The capital expenditure of the company. - `business_acquisitions_and_disposals` number — The business acquisitions and disposals of the company. - `investment_acquisitions_and_disposals` number — The investment acquisitions and disposals of the company. - `net_cash_flow_from_investing` number — The net cash flow from investing of the company. - `issuance_or_repayment_of_debt_securities` number — The issuance or repayment of debt securities of the company. - `issuance_or_purchase_of_equity_shares` number — The issuance or purchase of equity shares of the company. - `dividends_and_other_cash_distributions` number — The dividends and other cash distributions of the company. - `net_cash_flow_from_financing` number — The net cash flow from financing of the company. - `change_in_cash_and_equivalents` number — The change in cash and equivalents of the company. - `effect_of_exchange_rate_changes` number — The effect of exchange rate changes of the company. - `ending_cash_balance` number — The ending cash balance of the company. - `free_cash_flow` number — The free cash flow of the company. ## Other responses - `400` — Bad request - `401` — Unauthorized - `402` — The request requires a paid subscription --- [API](https://skmtc.net/financialdatasets/apis/financial-datasets-api.md) · [All operations](https://skmtc.net/financialdatasets/apis/financial-datasets-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/financialdatasets/financial-datasets-api/revisions/df2363101891/schema)