api-ninjas-com 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.
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.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/api-ninjas-com:api-ninjas-com-ipo-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Ninjas IPO API
description: 'Combined OpenAPI specification for every API Ninjas endpoint. Requests go to https://api.api-ninjas.com with an `X-Api-Key` header; get a free key at https://api-ninjas.com/register. Human-readable docs: https://api-ninjas.com/api. Index for LLMs: https://api-ninjas.com/llms.txt.'
version: 1.0.0
contact:
name: API Ninjas
url: https://api-ninjas.com
license:
name: Proprietary
servers:
- url: https://api.api-ninjas.com
description: API Ninjas Production
security:
- ApiKeyAuth: []
tags:
- name: IPO
description: 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.
paths:
/v1/ipocalendar:
get:
tags:
- IPO
summary: Get past, current, and upcoming IPO records
operationId: getIpoCalendar
description: Returns a list of IPO records matching the supplied filters. With no parameters, returns IPOs with listing dates between today and 30 days from now. All parameters are optional; combine them to narrow results by ticker, CIK, date range, status, deal type, exchange, or industry.
parameters:
- name: ticker
in: query
required: false
schema:
type: string
description: Company ticker symbol (e.g., RDDT). Returns IPO records for that specific company.
- name: cik
in: query
required: false
schema:
type: string
description: SEC Central Index Key, numeric only (padded or unpadded; e.g., 0001713445 or 1713445).
- name: date
in: query
required: false
schema:
type: string
format: date
description: Single date in YYYY-MM-DD format. Cannot be combined with date_start or date_end.
- name: date_start
in: query
required: false
schema:
type: string
format: date
description: Range start in YYYY-MM-DD format. Defaults to today. Free-tier users cannot query earlier than 24 months ago.
- name: date_end
in: query
required: false
schema:
type: string
format: date
description: Range end in YYYY-MM-DD format. Defaults to today + 30 days.
- name: date_field
in: query
required: false
schema:
type: string
enum:
- listing_date
- filing_date
default: listing_date
description: Which date the range filter applies to.
- name: status
in: query
required: false
schema:
type: string
description: 'Comma-separated list of statuses to filter by. Values: filed, amended, priced, listed, withdrawn.'
- name: deal_type
in: query
required: false
schema:
type: string
description: 'Comma-separated list of deal types to filter by. Values: ipo, spac_ipo, direct_listing.'
- name: exchange
in: query
required: false
schema:
type: string
enum:
- NASDAQ
- NYSE
- AMEX
description: U.S. exchange code.
- name: sic_code
in: query
required: false
schema:
type: string
pattern: ^[0-9]{1,4}$
description: SEC Standard Industrial Classification code (up to 4 digits).
- name: limit
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 1000
default: 50
description: Maximum number of results to return. Must be between 1 and 1000 (inclusive). Default is 50.
- name: offset
in: query
required: false
schema:
type: integer
minimum: 0
default: 0
description: Number of results to skip for pagination. Must be a non-negative integer.
responses:
'200':
$ref: '#/components/responses/IpoOpenapi_200'
'400':
$ref: '#/components/responses/IpoOpenapi_400'
'401':
$ref: '#/components/responses/IpoOpenapi_401'
'500':
$ref: '#/components/responses/IpoOpenapi_500'
security:
- ApiKeyAuth: []
components:
schemas:
IPOResponse:
type: array
items:
$ref: '#/components/schemas/IPORecord'
description: Array of IPO records matching the query.
IPORecord:
type: object
properties:
ticker:
type:
- string
- 'null'
description: Company ticker symbol.
name:
type: string
description: Issuer legal name.
cik:
type: string
description: SEC Central Index Key, zero-padded to 10 digits.
filing_date:
type:
- string
- 'null'
format: date
description: Date the initial S-1 was filed (YYYY-MM-DD).
amended_date:
type:
- string
- 'null'
format: date
description: Date of the most recent S-1/A amendment. Premium only — free tier users receive a placeholder upgrade message string in place of the value.
priced_date:
type:
- string
- 'null'
format: date
description: Date the final offer price was set (424B4 filing date).
listing_date:
type:
- string
- 'null'
format: date
description: First day of trading (YYYY-MM-DD).
lock_up_expiry_date:
type:
- string
- 'null'
format: date
description: Insider lock-up expiration date. Premium only — free tier users receive a placeholder upgrade message string in place of the date.
lock_up_days:
type:
- integer
- 'null'
description: Lock-up period in days. Premium only — free tier users receive a placeholder upgrade message string in place of the integer.
lock_up_method:
type:
- string
- 'null'
enum:
- parsed_from_prospectus
- computed_default_180d
- null
description: Source of the lock-up data. Premium only — free tier users receive a placeholder upgrade message string in place of the enum value.
status:
type: string
enum:
- filed
- amended
- priced
- listed
- withdrawn
description: IPO lifecycle stage.
deal_type:
type: string
enum:
- ipo
- spac_ipo
- direct_listing
description: Type of offering.
exchange:
type:
- string
- 'null'
enum:
- NASDAQ
- NYSE
- AMEX
- null
description: U.S. exchange code.
mic:
type:
- string
- 'null'
enum:
- XNAS
- XNYS
- XASE
- null
description: ISO 10383 Market Identifier Code. Premium only — free tier users receive a placeholder upgrade message string in place of the value.
state_location:
type:
- string
- 'null'
description: U.S. state of incorporation or headquarters (two-letter code). Premium only — free tier users receive a placeholder upgrade message string in place of the value.
sic_code:
type:
- string
- 'null'
description: SEC Standard Industrial Classification code (up to 4 digits).
industry:
type:
- string
- 'null'
description: Human-readable industry name derived from sic_code.
currency:
type: string
description: ISO 4217 currency code. Always USD at launch.
greenshoe_shares:
type:
- integer
- 'null'
description: Over-allotment option shares granted to underwriters. Premium only — free tier users receive a placeholder upgrade message string in place of the integer.
last_yr_revenue:
type:
- integer
- 'null'
description: Most recent annual revenue from the S-1, in USD. Premium only — free tier users receive a placeholder upgrade message string in place of the integer.
last_yr_net_income:
type:
- integer
- 'null'
description: Most recent annual net income from the S-1, in USD. Premium only — free tier users receive a placeholder upgrade message string in place of the integer.
last_yr_fiscal_year:
type:
- integer
- 'null'
description: Fiscal year corresponding to last_yr_revenue and last_yr_net_income. Premium only — free tier users receive a placeholder upgrade message string in place of the integer.
sec_filing_url:
type: string
format: uri
description: Link to the filing index page on SEC EDGAR.
prospectus_url:
type:
- string
- 'null'
format: uri
description: Direct deep link to the final prospectus (424B4) on SEC EDGAR. Premium only — free tier users receive a placeholder upgrade message string in place of the URL.
form_type:
type: string
description: Most recent governing SEC form (e.g., S-1, S-1/A, 424B4, 8-A12B, RW).
lead_underwriters:
type:
- array
- 'null'
items:
type: string
description: Array of lead underwriter / bookrunner names. Premium only — free tier users receive a placeholder upgrade message string in place of the array.
data_source:
type: string
enum:
- sec_edgar
description: How the record was created.
last_updated:
type: integer
description: Unix timestamp (UTC) of the last record refresh.
IpoOpenapi_ErrorResponse:
type: object
properties:
error:
type: string
description: Error message describing the failure.
responses:
IpoOpenapi_401:
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/IpoOpenapi_ErrorResponse'
IpoOpenapi_200:
description: A list of IPO records
content:
application/json:
schema:
$ref: '#/components/schemas/IPOResponse'
IpoOpenapi_500:
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/IpoOpenapi_ErrorResponse'
IpoOpenapi_400:
description: Bad Request
content:
application/json:
schema:
$ref: '#/components/schemas/IpoOpenapi_ErrorResponse'
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-Api-Key
externalDocs:
description: API Ninjas documentation
url: https://api-ninjas.com/api