IPOs

Get IPO filings

curl --request GET \
  --url https://api.financialdatasets.ai/ipos \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://api.financialdatasets.ai/ipos', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.financialdatasets.ai/ipos",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.financialdatasets.ai/ipos"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.financialdatasets.ai/ipos")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "ipos": [
    {
      "accession_number": "<string>",
      "cik": "<string>",
      "company_name": "<string>",
      "filing_date": "2023-12-25",
      "accepted_datetime": "2023-11-07T05:31:56Z",
      "filing_url": "<string>",
      "is_ipo_grade": true,
      "ticker": "<string>",
      "exchange": "<string>",
      "expected_offering_price": 123,
      "price_range_low": 123,
      "price_range_high": 123,
      "has_financial_statements": true,
      "has_price_on_cover": true,
      "financials": {
        "income_statements": [
          {
            "ticker": "<string>",
            "report_period": "2023-12-25",
            "fiscal_period": "<string>",
            "currency": "<string>",
            "accession_number": "<string>",
            "form_type": "<string>",
            "filing_url": "<string>",
            "filing_date": "2023-12-25",
            "filing_datetime": "2023-11-07T05:31:56Z",
            "revenue": 123,
            "cost_of_revenue": 123,
            "gross_profit": 123,
            "operating_expense": 123,
            "selling_general_and_administrative_expenses": 123,
            "research_and_development": 123,
            "operating_income": 123,
            "interest_expense": 123,
            "ebit": 123,
            "income_tax_expense": 123,
            "net_income_discontinued_operations": 123,
            "net_income_non_controlling_interests": 123,
            "net_income": 123,
            "net_income_common_stock": 123,
            "preferred_dividends_impact": 123,
            "consolidated_income": 123,
            "earnings_per_share": 123,
            "earnings_per_share_diluted": 123,
            "dividends_per_common_share": 123,
            "weighted_average_shares": 123,
            "weighted_average_shares_diluted": 123
          }
        ],
        "balance_sheets": [
          {
            "ticker": "<string>",
            "report_period": "2023-12-25",
            "fiscal_period": "<string>",
            "currency": "<string>",
            "accession_number": "<string>",
            "form_type": "<string>",
            "filing_url": "<string>",
            "filing_date": "2023-12-25",
            "filing_datetime": "2023-11-07T05:31:56Z",
            "total_assets": 123,
            "current_assets": 123,
            "cash_and_equivalents": 123,
            "inventory": 123,
            "current_investments": 123,
            "trade_and_non_trade_receivables": 123,
            "non_current_assets": 123,
            "property_plant_and_equipment": 123,
            "goodwill_and_intangible_assets": 123,
            "investments": 123,
            "non_current_investments": 123,
            "outstanding_shares": 123,
            "tax_assets": 123,
            "total_liabilities": 123,
            "current_liabilities": 123,
            "current_debt": 123,
            "trade_and_non_trade_payables": 123,
            "deferred_revenue": 123,
            "deposit_liabilities": 123,
            "non_current_liabilities": 123,
            "non_current_debt": 123,
            "tax_liabilities": 123,
            "shareholders_equity": 123,
            "retained_earnings": 123,
            "accumulated_other_comprehensive_income": 123,
            "total_debt": 123
          }
        ],
        "cash_flow_statements": [
          {
            "ticker": "<string>",
            "report_period": "2023-12-25",
            "fiscal_period": "<string>",
            "currency": "<string>",
            "accession_number": "<string>",
            "form_type": "<string>",
            "filing_url": "<string>",
            "filing_date": "2023-12-25",
            "filing_datetime": "2023-11-07T05:31:56Z",
            "net_income": 123,
            "depreciation_and_amortization": 123,
            "share_based_compensation": 123,
            "net_cash_flow_from_operations": 123,
            "capital_expenditure": 123,
            "business_acquisitions_and_disposals": 123,
            "investment_acquisitions_and_disposals": 123,
            "net_cash_flow_from_investing": 123,
            "issuance_or_repayment_of_debt_securities": 123,
            "issuance_or_purchase_of_equity_shares": 123,
            "dividends_and_other_cash_distributions": 123,
            "net_cash_flow_from_financing": 123,
            "change_in_cash_and_equivalents": 123,
            "effect_of_exchange_rate_changes": 123,
            "ending_cash_balance": 123,
            "free_cash_flow": 123
          }
        ]
      }
    }
  ]
}

{
  "error": "Bad Request",
  "message": "Invalid request parameters"
}

{
  "error": "Unauthorized",
  "message": "Invalid API key provided"
}

{
  "error": "Payment Required",
  "message": "This endpoint requires a paid subscription. Please upgrade your plan."
}

GET

ipos

Get IPO filings

curl --request GET \
  --url https://api.financialdatasets.ai/ipos \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://api.financialdatasets.ai/ipos', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.financialdatasets.ai/ipos",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.financialdatasets.ai/ipos"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.financialdatasets.ai/ipos")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "ipos": [
    {
      "accession_number": "<string>",
      "cik": "<string>",
      "company_name": "<string>",
      "filing_date": "2023-12-25",
      "accepted_datetime": "2023-11-07T05:31:56Z",
      "filing_url": "<string>",
      "is_ipo_grade": true,
      "ticker": "<string>",
      "exchange": "<string>",
      "expected_offering_price": 123,
      "price_range_low": 123,
      "price_range_high": 123,
      "has_financial_statements": true,
      "has_price_on_cover": true,
      "financials": {
        "income_statements": [
          {
            "ticker": "<string>",
            "report_period": "2023-12-25",
            "fiscal_period": "<string>",
            "currency": "<string>",
            "accession_number": "<string>",
            "form_type": "<string>",
            "filing_url": "<string>",
            "filing_date": "2023-12-25",
            "filing_datetime": "2023-11-07T05:31:56Z",
            "revenue": 123,
            "cost_of_revenue": 123,
            "gross_profit": 123,
            "operating_expense": 123,
            "selling_general_and_administrative_expenses": 123,
            "research_and_development": 123,
            "operating_income": 123,
            "interest_expense": 123,
            "ebit": 123,
            "income_tax_expense": 123,
            "net_income_discontinued_operations": 123,
            "net_income_non_controlling_interests": 123,
            "net_income": 123,
            "net_income_common_stock": 123,
            "preferred_dividends_impact": 123,
            "consolidated_income": 123,
            "earnings_per_share": 123,
            "earnings_per_share_diluted": 123,
            "dividends_per_common_share": 123,
            "weighted_average_shares": 123,
            "weighted_average_shares_diluted": 123
          }
        ],
        "balance_sheets": [
          {
            "ticker": "<string>",
            "report_period": "2023-12-25",
            "fiscal_period": "<string>",
            "currency": "<string>",
            "accession_number": "<string>",
            "form_type": "<string>",
            "filing_url": "<string>",
            "filing_date": "2023-12-25",
            "filing_datetime": "2023-11-07T05:31:56Z",
            "total_assets": 123,
            "current_assets": 123,
            "cash_and_equivalents": 123,
            "inventory": 123,
            "current_investments": 123,
            "trade_and_non_trade_receivables": 123,
            "non_current_assets": 123,
            "property_plant_and_equipment": 123,
            "goodwill_and_intangible_assets": 123,
            "investments": 123,
            "non_current_investments": 123,
            "outstanding_shares": 123,
            "tax_assets": 123,
            "total_liabilities": 123,
            "current_liabilities": 123,
            "current_debt": 123,
            "trade_and_non_trade_payables": 123,
            "deferred_revenue": 123,
            "deposit_liabilities": 123,
            "non_current_liabilities": 123,
            "non_current_debt": 123,
            "tax_liabilities": 123,
            "shareholders_equity": 123,
            "retained_earnings": 123,
            "accumulated_other_comprehensive_income": 123,
            "total_debt": 123
          }
        ],
        "cash_flow_statements": [
          {
            "ticker": "<string>",
            "report_period": "2023-12-25",
            "fiscal_period": "<string>",
            "currency": "<string>",
            "accession_number": "<string>",
            "form_type": "<string>",
            "filing_url": "<string>",
            "filing_date": "2023-12-25",
            "filing_datetime": "2023-11-07T05:31:56Z",
            "net_income": 123,
            "depreciation_and_amortization": 123,
            "share_based_compensation": 123,
            "net_cash_flow_from_operations": 123,
            "capital_expenditure": 123,
            "business_acquisitions_and_disposals": 123,
            "investment_acquisitions_and_disposals": 123,
            "net_cash_flow_from_investing": 123,
            "issuance_or_repayment_of_debt_securities": 123,
            "issuance_or_purchase_of_equity_shares": 123,
            "dividends_and_other_cash_distributions": 123,
            "net_cash_flow_from_financing": 123,
            "change_in_cash_and_equivalents": 123,
            "effect_of_exchange_rate_changes": 123,
            "ending_cash_balance": 123,
            "free_cash_flow": 123
          }
        ]
      }
    }
  ]
}

{
  "error": "Bad Request",
  "message": "Invalid request parameters"
}

{
  "error": "Unauthorized",
  "message": "Invalid API key provided"
}

{
  "error": "Payment Required",
  "message": "This endpoint requires a paid subscription. Please upgrade your plan."
}

Overview

The IPOs API gives you a real-time feed of SEC registration statements (Form S-1 and its amendments, Form S-1/A): the filings companies make before going public. Every filing is classified as one of ipo (a real operating company registering to list on an exchange), shell_company, spac, resale, or other, with structured metadata from the cover page: the proposed ticker, exchange, and expected offering price or price range. For IPO-grade filings, we extract the complete pre-IPO financial statements from the prospectus: income statements, balance sheets, and cash flow statements, including interim periods. These are embedded directly in each feed item under financials, in the exact same shape as our financial statements API. You can answer questions like:

Which companies filed to go public this week?
What are the revenue, margins, and cash burn of a company before it IPOs?
What ticker and exchange will a company list under, and at what expected price?

Filings are returned newest first.

For extracted IPO-grade filings, the same pre-IPO financial statements are also available under the company’s proposed ticker via the standard financials endpoints: income statements, balance sheets, and cash flow statements.

To get started, please create an account and grab your API key at financialdatasets.ai. You will use the API key to authenticate your API requests.

Coverage

Filings	History	Updated
Every SEC Form S-1 and S-1/A	Since July 2026	Real-time

Getting Started

There are only 3 steps for making a successful API call:

Add your API key to the header of the request as X-API-KEY.
Add query params like classification and limit to filter the data.
Execute the API request.

Filtering the Data

No parameters are required: by default, the API returns the latest filings across all companies. You can filter by ticker, cik, classification, limit, and filing_date. Note: by default, limit is 10 (max 100). The ticker parameter matches the proposed ticker from the filing’s cover page. The cik parameter matches the SEC Central Index Key of the filer, with or without leading zeros. The classification parameter filters to ipo, shell_company, spac, resale, or other. The filing_date parameter is used to filter by when filings were submitted. For example, you can include filters like filing_date_lte=2026-06-30 and filing_date_gte=2026-01-01 to get filings from the first half of 2026. The available filing_date operations are:

filing_date_lte
filing_date_lt
filing_date_gte
filing_date_gt
filing_date

Each item includes a status field describing where the filing is in our processing pipeline. A filing appears on the feed as soon as it is classified; financials is null until extraction completes, at which point status is COMPLETED and financials contains the full statement arrays.

Examples

import requests

# add your API key to the headers
headers = {
    "X-API-KEY": "your_api_key_here"
}

# set your query params
limit = 25          # number of filings to return

# create the URL
url = (
    f'https://api.financialdatasets.ai/ipos'
    f'?limit={limit}'
)

# make API request
response = requests.get(url, headers=headers)

# parse ipos from the response
ipos = response.json().get('ipos')

import requests

# add your API key to the headers
headers = {
    "X-API-KEY": "your_api_key_here"
}

# set your query params
classification = 'ipo'    # real operating companies going public

# create the URL
url = (
    f'https://api.financialdatasets.ai/ipos'
    f'?classification={classification}'
)

# make API request
response = requests.get(url, headers=headers)

# parse ipos from the response
ipos = response.json().get('ipos')

import requests

# add your API key to the headers
headers = {
    "X-API-KEY": "your_api_key_here"
}

# set your query params
ticker = 'SPCX'     # proposed ticker from the filing cover

# create the URL
url = (
    f'https://api.financialdatasets.ai/ipos'
    f'?ticker={ticker}'
)

# make API request
response = requests.get(url, headers=headers)

# parse ipos and the embedded financial statements
ipos = response.json().get('ipos')
financials = ipos[0].get('financials') if ipos else None

import requests

# add your API key to the headers
headers = {
    "X-API-KEY": "your_api_key_here"
}

# set your query params
filing_date_gte = '2026-07-01'    # filings from July 2026 onward

# create the URL
url = (
    f'https://api.financialdatasets.ai/ipos'
    f'?filing_date_gte={filing_date_gte}'
)

# make API request
response = requests.get(url, headers=headers)

# parse ipos from the response
ipos = response.json().get('ipos')

Authorizations

X-API-KEY

string

header

required

API key for authentication.

Query Parameters

ticker

string

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

cik

string

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

classification

enum<string>

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

Available options:

ipo,

shell_company,

spac,

resale,

other

filing_date

string<date>

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

filing_date_gte

string<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_lte

string<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_gt

string<date>

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

filing_date_lt

string<date>

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

limit

integer

default:10

The maximum number of filings to return (default: 10, max: 100).

Response

IPOs response

ipos

object[]

Show child attributes

Snapshot Company News

Overview

Integrations

Datasets

Guides

Overview

Coverage

Getting Started

Filtering the Data

Examples

Authorizations

Query Parameters

Response

​Overview

​Coverage

​Getting Started

​Filtering the Data

​Examples

Authorizations

Query Parameters

Response

Overview

Coverage

Getting Started

Filtering the Data

Examples