NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →

IPO API

The IPO API provides access to past, current, and upcoming Initial Public Offerings (IPOs) for U.S. companies. Filter by ticker, CIK, date range, status, deal type, exchange, and industry.

Online
(4.2)

From 6,661 users

600+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
290ms321ms341ms692ms1052ms

Didn't find what you were looking for? Suggest an improvement

https://api.api-ninjas.com/v1/ipocalendar

Returns a list of IPO records matching your filters. With no parameters, returns the current IPO calendar — companies in registration plus IPOs listed in the last 90 days, most recent first. Up to 50 records are returned per request by default (configurable via limit, max 1000).

Parameters

All parameters are optional.

  • ticker  optional

    Company ticker symbol (e.g., RDDT). Returns IPO records for that specific company.

  • cik  optional

    SEC Central Index Key (e.g., 0001713445 or 1713445). Numeric only; padding is handled server-side.

  • date  optional

    Single date in YYYY-MM-DD format. Cannot be combined with date_start or date_end.

  • date_start  optional

    Range start in YYYY-MM-DD format. Free-tier users cannot query earlier than 24 months ago.

  • date_end  optional

    Range end in YYYY-MM-DD format.

  • date_field  optional

    Which date the range applies to: listing_date (default) or filing_date.

  • status  optional

    Comma-separated list of statuses. Values: filed, amended, priced, listed, withdrawn.

  • deal_type  optional

    Comma-separated list of deal types. Values: ipo, spac_ipo, direct_listing.

  • exchange  optional

    U.S. exchange code: NASDAQ, NYSE, or AMEX.

  • sic_code  optional

    SEC Standard Industrial Classification code (up to 4 digits). Filters by industry — e.g., 2834 for pharmaceuticals.

  • limit  optional

    Maximum results to return. Default 50, max 1000.

  • offset  optional

    Number of results to skip for pagination. Default 0.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

The /v1/ipocalendar endpoint returns a JSON array of IPO records, each containing the following fields, or an error if the request is unsuccessful. Fields marked Premium only return an upgrade prompt for free-tier requests.

  • ticker

    Company ticker symbol.

  • name

    Issuer legal name.

  • cik

    SEC Central Index Key (zero-padded to 10 digits).

  • filing_date

    Date the initial S-1 was filed (YYYY-MM-DD).

  • amended_date Premium only

    Date of the most recent S-1/A amendment.

  • priced_date

    Date the final offer price was set (424B4 filing date).

  • listing_date

    First day of trading.

  • lock_up_expiry_date Premium only

    Insider lock-up expiration date.

  • lock_up_days Premium only

    Lock-up period in days.

  • lock_up_method Premium only

    Source of the lock-up data: parsed_from_prospectus or computed_default_180d.

  • status

    IPO lifecycle stage: one of filed, amended, priced, listed, withdrawn.

  • deal_type

    Type of deal: ipo, spac_ipo, or direct_listing.

  • exchange

    NASDAQ, NYSE, or AMEX.

  • mic Premium only

    ISO 10383 Market Identifier Code.

  • state_location Premium only

    U.S. state of incorporation or HQ.

  • sic_code

    SEC Standard Industrial Classification code.

  • industry

    Industry name derived from SIC code.

  • currency

    Currency code (always USD at launch).

  • greenshoe_shares Premium only

    Over-allotment option shares granted to underwriters.

  • last_yr_revenue Premium only

    Most recent annual revenue from the S-1, in USD.

  • last_yr_net_income Premium only

    Most recent annual net income from the S-1, in USD.

  • last_yr_fiscal_year Premium only

    Fiscal year corresponding to the revenue/income figures.

  • sec_filing_url

    Link to the filing index on SEC EDGAR.

  • prospectus_url Premium only

    Direct deep link to the final prospectus (424B4).

  • form_type

    Most recent governing form: S-1, S-1/A, 424B4, etc.

  • lead_underwriters Premium only

    Array of lead underwriter / bookrunner names.

  • data_source

    How the record was created: sec_edgar or manual.

  • last_updated

    Unix timestamp (UTC) of the last record refresh.

Live Demo

Live demo · no API key required
Query parameters
ticker
cik
date_start
date_end
status
deal_type
exchange
sic_code
limit

Get a free API key to get started — no credit card required.

Headers
X-Api-KeyLog in or sign up to get your API key
GET
https://api.api-ninjas.com/v1/ipocalendar?ticker=RDDT
Sample response
[
{
"ticker": "RDDT",
"name": "Reddit, Inc.",
"cik": "0001713445",
"filing_date": "2024-02-22",
"priced_date": "2024-03-20",
"listing_date": "2024-03-21",
"status": "listed",
"deal_type": "ipo",
"exchange": "NYSE",
"sic_code": "7374",
"industry": "Services-Computer Processing & Data Preparation",
"currency": "USD",
"sec_filing_url": "https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=0001713445&type=S-1",
"form_type": "8-A12B",
"data_source": "sec_edgar",
"last_updated": 1711065600,
"lock_up_expiry_date": "This field is available for premium subscribers only. Please visit https://api-ninjas.com/pricing to upgrade.",
"lead_underwriters": "This field is available for premium subscribers only. Please visit https://api-ninjas.com/pricing to upgrade.",
"greenshoe_shares": "This field is available for premium subscribers only. Please visit https://api-ninjas.com/pricing to upgrade.",
"last_yr_revenue": "This field is available for premium subscribers only. Please visit https://api-ninjas.com/pricing to upgrade."
}
]

Code Examples

curl -X GET "https://api.api-ninjas.com/v1/ipocalendar?ticker=RDDT" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the IPO API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
  • The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
  • It covers past, current, and upcoming Initial Public Offerings for U.S. companies, tracking the full lifecycle through the status field (filed, amended, priced, listed, withdrawn) along with key dates like filing_date, priced_date, and listing_date. For the full text of company filings, see the SEC API.
  • Pass either the ticker parameter (e.g. RDDT) or the SEC cik (e.g. 0001713445 or 1713445, since padding is handled server-side) to the /v1/ipocalendar endpoint. To pair this with post-listing trading data, see the Stock Price API or resolve identifiers with the Ticker API.
  • Use date_start and date_end (both YYYY-MM-DD) to define a window, and set date_field to either listing_date (default) or filing_date to choose which date the range filters on; with no parameters the endpoint returns the current IPO calendar: companies in registration plus IPOs listed in the last 90 days. Free-tier requests cannot query a date_start earlier than 24 months ago, so deeper history requires a paid plan, and you can page through large result sets with limit (default 50, max 1000) and offset.
  • Each record includes core fields such as name, exchange (NASDAQ, NYSE, or AMEX), deal_type, sic_code, industry, form_type, and a sec_filing_url. Premium-gated fields like lock_up_expiry_date, lead_underwriters, greenshoe_shares, and last_yr_revenue return an upgrade prompt on the free tier and require a paid plan.

Explore API integration use cases for recommended APIs and workflow examples.