NewConnect Claude, Cursor, 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
249ms290ms305ms549ms971ms

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 this API endpoint with all available parameters in our API playground

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

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.