FIfinancialdatasets
IPOs

Get IPO filings

Changed on

Get SEC IPO filings (registration statements S-1, S-1/A, F-1, F-1/A and final prospectuses 424B4, 424B1), 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.

get/ipos

Request

  • Base URL
    https://api.financialdatasets.ai
  • Auth
    API key in header X-API-KEY

Query parameters

tickerstring

Filter by the proposed ticker symbol from the filing's cover page.

cikstring

Filter by the SEC Central Index Key of the filer, with or without leading zeros.

classification'ipo' | 'shell_company' | 'spac' | 'resale' | 'other'

Filter by filing classification: ipo (a real operating company registering to list on an exchange), shell_company, spac, resale, or other.

filing_datestring date

Filter by exact SEC filing date in YYYY-MM-DD format. Rows without a known filing date are excluded.

filing_date_gtestring date

Filter by SEC filing date greater than or equal to date in YYYY-MM-DD format. Rows without a known filing date are excluded.

filing_date_ltestring date

Filter by SEC filing date less than or equal to date in YYYY-MM-DD format. Useful for point-in-time queries: returns only data that was publicly filed by the given date. Rows without a known filing date are excluded.

filing_date_gtstring date

Filter by SEC filing date greater than date in YYYY-MM-DD format. Rows without a known filing date are excluded.

filing_date_ltstring date

Filter by SEC filing date less than date in YYYY-MM-DD format. Rows without a known filing date are excluded.

limitinteger

The total number of rows to return (default: 10; no maximum). This is the total across all pages, not a page size: each page holds up to 10 records, linked by next_page_url.

cursorstring

Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it.

Response

IPOs response

next_page_urlstring

Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records.

Changes

  • 5872e134b56cRevision changes
    • warning

      added the new 424B1 enum value to the // response property for the response status

    • warning

      added the new 424B4 enum value to the // response property for the response status

    • warning

      added the new F-1 enum value to the // response property for the response status

    • warning

      added the new F-1/A enum value to the // response property for the response status

    • info

      added the new optional query request parameter cursor

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property to the response with the status