--- title: "Get Offering" method: GET path: "/v1/private-markets/offerings/{offering_id}" tags: ["Private Markets"] --- # Get Offering `GET /v1/private-markets/offerings/{offering_id}` ## Request - Base URL: `https://api.clearstreet.com` - URL: `https://api.clearstreet.com/v1/private-markets/offerings/{offering_id}` - Auth: HTTP bearer Fetch one visible private-market offering with its documents, participants, and any attached SPV. Requires the account holder to have attested. Returns `404` when the offering does not exist or is not currently visible. ## Path parameters - `offering_id` string, uuid, required ## Query parameters - `account_id` integer, required ## Response `200` The offering - object - `error` ApiError: A direct mapping of tonic::Status, for use in HTTP responses. - `code` integer, required: The error code is used to identify the nature of the error. It corresponds to an HTTP status code. - `details` object[] - `message` string, required: A human-readable message providing more details about the error. - `metadata` ResponseMetadata, required: Metadata for the response. This will always contain a request ID which can be used to identify the request to Clear Street for tracing, and optionally may include pagination data. - `next_page_token` string, byte, nullable: Base64URL-encoded pagination token - `page_number` integer, nullable: Pagination. Included if this was a GET (list) response - `previous_page_token` string, byte, nullable: Base64URL-encoded pagination token - `request_id` string, required: A unique ID for this request, generated upon ingestion of the request. - `total_items` integer, nullable: Total number of items available (not just in this page). - `total_pages` integer, nullable: Total number of pages available. - `data` OfferingDetail, required: One offering with everything needed to render its detail payload. - `class` 'UPCOMING' | 'ACTIVE', required: Derived offering classification. - `company` OfferingCompany, required: Company identity carried on an offering card/detail. - `id` string, uuid, required: Stable company identifier. - `logo_url` string, nullable: Company logo URL, when known. - `name` string, required: Display name. - `primary_domain` string, nullable: Canonical lowercase domain, when known. - `short_description` string, required: Short card/search description. - `slug` string, required: Lowercase URL slug. - `currency` 'USD', required: Terms currency. - `headline` string, required: Card/detail headline. - `id` string, uuid, required: Stable public identifier; IOIs and history hang off it. - `indicative_price_high` string, nullable: Indicative price-per-share range, high endpoint. - `indicative_price_low` string, nullable: Indicative price-per-share range, low endpoint. - `indicative_valuation_basis` 'PRE_MONEY' | 'POST_MONEY' | 'REFERENCE' | 'IMPLIED': Meaning of an indicative valuation range or an SPV valuation. - `indicative_valuation_high` string, nullable: Indicative valuation range, high endpoint. - `indicative_valuation_low` string, nullable: Indicative valuation range, low endpoint. - `ioi_deadline` string, date-time, nullable: Deadline for indications of interest. - `minimum_ioi_amount` string, nullable: Minimum indication-of-interest amount. - `spv` OfferingSpv: The attached SPV's identity and lifecycle. Exact economics surface once the SPV opens; an upcoming offering's indicative ranges describe the terms until then. - `custodian_name` string, nullable: Custodian. - `id` string, uuid, required: Stable SPV identifier. - `manager_name` string, nullable: SPV manager. - `name` string, required: Legal/display name. - `nda_agreement` NdaAgreementResource: Current NDA agreement for an SPV-backed deal. - `acceptance_text` string, required: Exact assent and authority representation shown to the signer. - `acceptance_text_version` integer, required: Version of the acceptance representation. - `agreement_id` string, uuid, required: Stable agreement identifier submitted with an IOI acceptance. - `document_reference` string, required: Durable reference to the immutable NDA artifact. - `document_sha256` string, required: Lowercase SHA-256 digest of the artifact bytes. - `effective_at` string, date-time, required: Time this version became effective. - `version` integer, required: Strictly increasing SPV-local agreement version. - `share_class` string, nullable: Underlying share class, when specified. - `status` 'DRAFT' | 'OPEN' | 'CLOSED' | 'LIQUIDATING' | 'DISSOLVED', required: SPV lifecycle state. - `structure_description` string, nullable: Plain-text vehicle structure. - `summary` string, required: Top opportunity paragraph. - `disclosures` string, nullable: Important disclosures. - `documents` OfferingDocumentResource[]: Campaign documents in display order. - `display_order` integer, required: Stable display position. - `document_type` 'TEARSHEET' | 'KEY_TERMS' | 'RISK_FACTORS' | 'PPM' | 'OTHER', required: Kind of campaign document. - `id` string, uuid, required: Stable identifier. - `object_key` string, nullable: Object-store key, when the document is stored internally. - `published_at` string, date-time, nullable: Publication time, when known. - `source` string, nullable: Source publisher/provider. - `source_url` string, nullable: Source URL. - `title` string, required: Display title. - `url` string, nullable: Externally reachable URL, when the document lives at one. - `highlights` OfferingHighlight[]: Ordered resolved highlights. - `label` string, required: Display label (the highlight's override, else the series' own label). - `metric_key` string, required: Canonical metric key selected by the highlight (e.g. `REVENUE_GROWTH`). - `observed_at` string, date-time, nullable: Observation time of the latest value. - `unit` 'USD' | 'PERCENT' | 'COUNT' | 'RANK', required: Unit for a resolved highlight metric. - `value` string, nullable: Latest observed value, when the series carries any points. - `value_type` 'HISTORICAL' | 'ESTIMATED': Whether a resolved highlight value is observed or estimated. - `investment_thesis` string, nullable: Campaign-specific investment framing. - `key_risks` OfferingKeyRisk[]: Ordered key risks. - `body` string, required: Plain-text risk body. - `citation_ids` string[]: Profile-local citation ids supporting the risk. - `title` string, required: Risk heading. - `participants` OfferingParticipantResource[]: Campaign participants in display order. - `display_order` integer, required: Stable display position. - `id` string, uuid, required: Stable identifier. - `name` string, required: Display name. - `role` 'LEAD_INVESTOR' | 'CO_LEAD' | 'FUND_MANAGER' | 'PLACEMENT_AGENT', required: Presentation role of an offering participant. - `structure_description` string, nullable: Vehicle/structure framing shown before typed SPV terms exist. - `why_now` string, nullable: Why-now framing. ## Other responses - `401`: Unauthenticated - `403`: Caller lacks account access, or the account holder has not attested - `404`: Account not found, or offering not found or not visible - `500`: Internal server error ## Changes - **2026-10-16** `1bd9eddeffc8`: 1 info - endpoint added [Operation history](https://skmtc.dev/clear-street/apis/clear-street-trading-api/changes/v1/private-markets/offerings/:offering_id/get.md) --- [API](https://skmtc.dev/clear-street/apis/clear-street-trading-api.md) - [All operations](https://skmtc.dev/clear-street/apis/clear-street-trading-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clear-street/apis/clear-street-trading-api/revisions/52e77ea7d731?raw)