---
title: "GET /v1/reference/ipos"
method: GET
path: "/v1/reference/ipos"
tags: ["us_stocks_reference"]
---

# GET /v1/reference/ipos

`GET /v1/reference/ipos`

Contains comprehensive data about Initial Public Offerings (IPOs) and direct listings for US stocks, tracking both historical and pending offerings with detailed pricing, share, and timing information.

## Query parameters

- `ticker` string
- `ticker.any_of` string
- `ticker.gt` string
- `ticker.gte` string
- `ticker.lt` string
- `ticker.lte` string
- `us_code` string
- `us_code.any_of` string
- `us_code.gt` string
- `us_code.gte` string
- `us_code.lt` string
- `us_code.lte` string
- `isin` string
- `isin.any_of` string
- `isin.gt` string
- `isin.gte` string
- `isin.lt` string
- `isin.lte` string
- `listing_date` string
- `listing_date.gt` string
- `listing_date.gte` string
- `listing_date.lt` string
- `listing_date.lte` string
- `ipo_status` 'direct_listing_process' | 'history' | 'new' | 'pending' | 'postponed' | 'rumor' | 'withdrawn'
- `ipo_status.any_of` 'direct_listing_process' | 'history' | 'new' | 'pending' | 'postponed' | 'rumor' | 'withdrawn'
- `limit` integer
- `sort` string

## Response `200`

A list of results.

- object
  - `next_url` string — If present, this value can be used to fetch the next page.
  - `request_id` string, required — A request id assigned by the server.
  - `results` object[], required — The results for this request.
    - `announced_date` integer — The date when the IPO event was announced.
    - `currency_code` string — Underlying currency of the security.
    - `final_issue_price` number, double — The price set by the company and its underwriters before the IPO goes live.
    - `highest_offer_price` number, double — The highest price within the IPO price range that the company might use to price the shares.
    - `ipo_status` string — The status of the IPO.
    - `isin` string — International Securities Identification Number. This is a unique twelve-digit code that is assigned to every security issuance in the world.
    - `issuer_name` string — Name of issuer.
    - `last_updated` integer — The date when the IPO event was last modified.
    - `listing_date` integer — First trading date for the newly listed entity.
    - `lot_size` integer — The minimum number of shares that an investor may apply for during an IPO.
    - `lowest_offer_price` number, double — The lowest price within the IPO price range that the company is willing to offer its shares to investors.
    - `max_shares_offered` integer — The upper limit of the shares that the company is offering to investors.
    - `min_shares_offered` integer — The lower limit of shares that the company is willing to sell in the IPO.
    - `primary_exchange` string — Market Identifier Code (MIC) of the primary exchange where the security is listed. The Market Identifier Code (MIC) (ISO 10383) is a unique identification code used to identify securities trading exchanges, regulated and non-regulated trading markets.
    - `security_description` string — A brief description of the security. e.g. Class A Shares
    - `security_type` string — The classification of the stock. For example, CS stands for Common Stock.
    - `shares_outstanding` integer — The total number of shares that the company has issued and are held by investors.
    - `ticker` string — The ticker symbol of the IPO event.
    - `total_offer_size` number, double — The total amount raised by the company for IPO.
    - `us_code` string — Nine-character alphanumeric code that uniquely identifies a financial security in North America.
  - `status` 'OK', required — The status of this request's response.

## Other responses

- `400` — An error message.

---

[API](https://skmtc.net/massive/apis/polygon-api.md) · [All operations](https://skmtc.net/massive/apis/polygon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/massive/polygon-api/revisions/ad6f143e43aa/schema)