---
title: "US Equities IPO Detailed"
method: GET
path: "/v1/data/us-equity-ref/ipo-detailed"
tags: ["us-equity-ref-market-events"]
---

# US Equities IPO Detailed

`GET /v1/data/us-equity-ref/ipo-detailed`

The U.S. Equities IPO (Detailed) dataset provides comprehensive reference information on Initial Public Offering (IPO) events for equities listed on U.S. public exchanges, excluding securities traded on the OTC market. Like the basic IPO dataset, records are typically available several days prior to the first trading day, enabling early identification and monitoring of upcoming offerings. Core fields include ticker symbol, algoseek SecId, ISIN, first trading date, and IPO status indicators that track outcomes such as completed, postponed, or otherwise modified offerings. In addition to these core attributes, the detailed dataset includes expanded offering-level metadata, such as par value, initial offering price, and underwriter information. This enhanced field coverage supports deeper analysis of IPO structure, pricing context, and issuance characteristics, and is well suited for research, security master enrichment, and historical event analysis.

 For more details, please refer to the dataset documentation: [US Equities IPO Detailed Guide](https://us-equity-reference-docs.s3.us-east-1.amazonaws.com/algoseek.US.Equity.IPO.pdf).

<details>
<summary>**Advanced Filtering**</summary>

You can provide one or multiple filter expressions based on the dataset's columns to narrow down the results. For example, `StartDate.gt=2023-01-01&StartDate.lt=2023-12-31`, `Ticker=AAPL`. 

Please refer to the <a href="https://algoseek.com/docs/rest-api/tutorial/advanced-filtering">Advanced Filtering Guide</a> for the extensive reference.
</details>

## Query parameters

- `sort` string, nullable — Sorting criteria for the results. Provide a column name with optional prefix '+' for ascending order, or prefix with '-' for descending order. Multiple sorting fields may be supported depending on the dataset. If sort prefix is not provided, the ascending order is applied.
- `columns` string, nullable — A comma-separated list of columns to include in the response. Use this parameter to select only specific fields from the dataset. If not provided, all available columns will be returned.
- `offset` integer — Number of records to skip before returning results. To be used with the `limit` parameter for pagination. If not provided, defaults to 0.
- `limit` integer — Maximum number of records to return. Default and maximum values depend on the response format; see `format_limits` in the schema for details.
- `response_format` 'json' | 'csv' | 'csv_gzip' — Note the lowercase which is used for the consistency with other projects and tools

## Response `200`

JSON, CSV file, or gzip-compressed CSV file, depending on the value of `response_format` query parameter

- USEquitiesIPODetailedDataOut
  - `data` USEquitiesIPODetailedDataDetailsOut[], required
    - `CreatedDate` string, date, nullable — Trading date when the record was created
    - `ModifiedDate` string, date, nullable — Trading date when record was updated
    - `Revision` integer, nullable — Version number
    - `SecId` integer, nullable — A unique identifier for a security
    - `Ticker` string, nullable — Symbol name
    - `Name` string, nullable — Security name
    - `SecDescription` string, nullable — Security Description
    - `ParValue` number, nullable — Security Parvalue
    - `PVCurrency` string, nullable — Security Parvalue ISO currency code
    - `SharePriceLowest` number, nullable — Lowest offer price during IPO
    - `SharePriceHighest` number, nullable — Highest offer price during IPO
    - `ProposedPrice` number, nullable — Final Issue Price
    - `InitialPrice` number, nullable — First Listing Price
    - `USIdentifier` string, nullable — USIdentifiers for US securities
    - `ISIN` string, nullable — International Securities Identification Number
    - `FirstTradingDate` string, date, nullable — First trading Date
    - `Underwriter` string, nullable — Underwriter to the issue
    - `DealType` string, nullable — Underwriting level
    - `LawFirm` string, nullable — Lawfirm company name
    - `TransferAgent` string, nullable — Transfer Agent name
    - `ExchangeCode` string, nullable — Code for an exchange
    - `Status` string, nullable — Indicates the status of IPO
  - `pagination` PaginationDetailsOut, required
    - `offset` integer — The number of records skipped to fetch the current page
    - `limit` integer, required — The maximum number of records in the current page
    - `next_offset` integer, nullable — The number of records to skip to fetch the next page

## Other responses

- `403` — Forbidden
- `422` — Validation Error
- `429` — Request rejected because the identity or team exceeded a configured monthly or per-minute usage quota. When available, the response includes rate-limit headers describing the current quota.

---

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