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

# Retrieve an IPO Offering

`GET /v1/ipos/{offering_reference}`

## Request

- Base URL: `https://broker-api.giftcity.sandbox.in.alpaca.markets`
- URL: `https://broker-api.giftcity.sandbox.in.alpaca.markets/v1/ipos/{offering_reference}`
- Auth: HTTP basic

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.dev/alpacahq/apis/broker-api.md) - [All operations](https://skmtc.dev/alpacahq/apis/broker-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alpacahq/apis/broker-api/revisions/381b1ecb3ccc?raw)