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, sourced directly from SEC EDGAR. Filter by ticker, CIK, date range, status, deal type, exchange, industry, and offer size.

(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

/v1/ipocalendar GET

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

Returns a list of IPO records matching your filters. With no parameters, returns IPOs with listing dates between today and 30 days from now. 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. Defaults to today. Free-tier users cannot query earlier than 24 months ago.

  • date_end  optional

    Range end in YYYY-MM-DD format. Defaults to today + 30 days.

  • 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, completed, withdrawn, postponed.

  • deal_type  optional

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

  • 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

A JSON array of IPO records, each containing the following fields, or an error if the request is unsuccessful. Fields marked premium return an upgrade prompt for free-tier requests.

  • ticker

    Company ticker symbol. Null when not yet assigned (early filed stage).

  • 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

    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.

  • listing_date_verified

    true once trading has begun (confirmed via 8-A filing); false while the date is estimated.

  • lock_up_expiry_date premium

    Insider lock-up expiration date.

  • lock_up_days premium

    Lock-up period in days.

  • lock_up_method premium

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

  • status

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

  • deal_type

    Type of deal: ipo, direct_listing, spac_ipo, de_spac, secondary, or follow_on.

  • exchange

    NASDAQ, NYSE, or AMEX.

  • mic premium

    ISO 10383 Market Identifier Code.

  • state_location premium

    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

    Over-allotment option shares granted to underwriters.

  • last_yr_revenue premium

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

  • last_yr_net_income premium

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

  • last_yr_fiscal_year premium

    Fiscal year corresponding to the revenue/income figures.

  • sec_filing_url

    Link to the filing index on SEC EDGAR.

  • prospectus_url premium

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

  • form_type

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

  • lead_underwriters premium

    Array of lead underwriter / bookrunner names.

  • data_source

    Source of the record: sec_edgar or manual.

  • last_updated

    Unix timestamp (UTC) of the last record refresh.

Sample Request Live Demo!

ticker
cik
date_start
date_end
status
deal_type
exchange
sic_code
limit

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

https://api.api-ninjas.com/v1/ipocalendar?ticker=RDDT

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
[
    {
      ticker:"RDDT",
      name:"Reddit, Inc.",
      cik:"0001713445",
      filing_date:"2024-02-22",
      priced_date:"2024-03-20",
      listing_date:"2024-03-21",
      listing_date_verified:true,
      status:"listed",
      deal_type:"ipo",
      exchange:"NYSE",
      sic_code:"7372",
      industry:"Prepackaged Software",
      currency:"USD",
      sec_filing_url:"https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=0001713445&type=S-1",
      form_type:"424B4",
      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

1 2 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 sourced directly from SEC EDGAR (indicated by a data_source of sec_edgar), tracking the full lifecycle through the status field (filed, amended, priced, listed, completed, withdrawn, postponed) along with key dates like filing_date, priced_date, and listing_date. To pull the underlying filings yourself, 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 IPOs listing between today and 30 days out. 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, plus a listing_date_verified flag that is true once trading begins (confirmed via an 8-A filing). 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.