---
title: "Retrieve an IPO Offering"
method: GET
path: "/v1/ipos/{offering_reference}"
tags: ["IPO"]
---

# Retrieve an IPO Offering

`GET /v1/ipos/{offering_reference}`

Returns a single IPO offering by `offering_reference`.

The `offering_reference` value matches the one delivered on the [IPO Events Stream](#operation/subscribeToIPOEventsSSE).

## Response `200`

The requested IPO offering.

- IPOOfferingResponse — Wrapper response returned by `GET /v1/ipos/{offering_reference}`.
  - `data` IPOOffering, required — An IPO (Initial Public Offering) offering exposed via the IPO discovery REST API. Returned by `GET /v1/ipos` and `GET /v1/ipos/{offering_reference}`. Most IPO lifecycle changes (new offerings, prospectus availability, 60-minute mail, allocations, cancellations) are pushed in real time over the [IPO Events Stream](#operation/subscribeToIPOEventsSSE).
    - `anticipated_shares` integer — Anticipated total share count for the offering, when known.
    - `availability` 'available' | 'not_available' | 'closed', required — Whether the offering is currently accepting orders. - `available` - accepting new orders. - `not_available` - not yet open for orders. - `closed` - no longer accepting orders. Note: the IPO Events Stream uses a different casing for the analogous `payload.available_to_order` field on `Offering`/`OfferingUpdate` events (`Available`, `NotAvailable`, `Closed`).
    - `cusip_id` string — CUSIP identifier of the offering.
    - `description` string — A longer human-readable description of the offering, when available.
    - `ipo_reference` string, required — The unique offering identifier used across the IPO Events Stream and `/v1/ipos/{offering_reference}`. Note that this value is also used as the path parameter, where it is named `offering_reference`.
    - `logo_small` string — URL to a small logo asset for the issuer.
    - `max_price` string, decimal, required — Upper bound of the indicated price range.
    - `max_ticket_size` string — Maximum allowed order amount.
    - `min_price` string, decimal, required — Lower bound of the indicated price range.
    - `min_ticket_size` string — Minimum allowed order amount.
    - `name` string, required — The official name of the offering.
    - `no_new_orders` boolean, required — When `true`, the offering is in its 60-minute pricing window and is not accepting new orders. This mirrors the `SixtyMinMail` event on the IPO Events Stream.
    - `offering_type` string, required — The type of offering. Currently always `IPO`.
    - `prospectus_url` string — URL to the prospectus document. Mirrors the `prospectus_url` payload of the corresponding `Prospectus` event on the IPO Events Stream.
    - `settlement_date` string, date — Anticipated settlement date.
    - `ticker_symbol` string — The ticker symbol that will be used once the security begins trading on the secondary market.
    - `trade_date` string, date — Anticipated first trading date on the secondary market.
    - `underwriters` string[] — List of underwriter names participating in the offering.
    - `unit_step_size` string — The minimum increment in which order quantities can be specified.

## Other responses

- `404` — No IPO offering exists for the given `offering_reference`.

---

[API](https://skmtc.net/alpacahq/apis/gift-city-extensions-api.md) · [All operations](https://skmtc.net/alpacahq/apis/gift-city-extensions-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alpacahq/gift-city-extensions-api/revisions/62e3378bb273/schema)