api-ninjas-com IPO API

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