--- title: "Get Company" method: GET path: "/v1/private-markets/companies/{company_id}" tags: ["Private Markets"] --- # Get Company `GET /v1/private-markets/companies/{company_id}` ## Request - Base URL: `https://api.clearstreet.com` - URL: `https://api.clearstreet.com/v1/private-markets/companies/{company_id}` - Auth: HTTP bearer Fetch one published private-market company with its complete versioned profile. Requires the account holder to have attested. Returns `404` when the company does not exist or is not yet published. ## Path parameters - `company_id` string, uuid, required ## Query parameters - `account_id` integer, required ## Response `200` The company - 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` CompanyDetail, required: A company's identity and its complete published profile. - `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. - `profile` CompanyProfileResource, required: The complete versioned company profile (schema version one). - `categories` CompanyCategory[]: Company categories. - `name` string, required: Display name. - `slug` string, required: Stable lowercase category slug. - `citations` CompanyCitation[]: Sources referenced by narrative sections and metrics. - `id` string, required: Stable profile-local citation identifier. - `published_at` string, date-time, nullable: Source publication time, when known. - `source` string, required: Source publisher or provider. - `title` string, required: Human-readable source title. - `url` string, required: Source URL. - `customers` CompanyCustomer[]: Named customers evidenced by the source material. - `logo_url` string, nullable: Customer logo, when supplied. - `name` string, required: Customer name. - `documents` CompanyDocumentResource[]: Company-level research and source documents. - `document_type` 'COMPANY_PROFILE' | 'MARKET_RESEARCH' | 'INTERVIEW' | 'DEAL_SHEET' | 'PRESS_RELEASE' | 'NEWS' | 'OTHER', required: Company document kind. - `external_id` string, nullable: Optional source identifier retained for reconciliation. - `preview` CompanyDocumentPreview: Optional document card preview. - `description` string, nullable: Preview description. - `image_url` string, nullable: Preview image URL. - `published_at` string, date-time, nullable: Publication time, when known. - `relation` 'SUBJECT' | 'CONNECTED', required: How a document relates to the company. - `title` string, required: Display title. - `url` string, required: Document URL. - `headquarters` CompanyHeadquarters: Company headquarters. - `city` string, required: City. - `country` string, required: Country. - `legal_entities` CompanyLegalEntity[]: Known legal entities associated with the company. - `country` string, required: Country name or ISO country code supplied by the source. - `name` string, required: Legal name. - `metric_series` CompanyMetricSeries[]: Historical and estimated metric series. - `external_id` string, nullable: Optional source identifier retained for reconciliation. - `frequency` 'YEAR' | 'QUARTER' | 'MONTH' | 'POINT_IN_TIME', required: Observation cadence for a metric series. - `label` string, required: Display label. - `metric_key` 'ANNUALIZED_REVENUE' | 'REVENUE_GROWTH' | 'VALUATION' | 'ISSUE_PRICE' | 'PRICE_PER_SHARE' | 'AMOUNT_RAISED' | 'ORDER_VOLUME' | 'PIPELINE_VALUE' | 'GROSS_MARGIN' | 'EBIT_MARGIN' | 'FCF_CONVERSION' | 'CONTRACTED_REVENUE_PERCENT' | 'NET_REVENUE_RETENTION' | 'CUSTOMER_COUNT' | 'MARKET_POSITION', required: Canonical company metric key. - `points` CompanyMetricPoint[]: Ordered observations. - `citation_ids` string[]: Profile-local citation ids supporting this point. - `observed_at` string, date-time, required: Observation time. - `source_event_id` string, nullable: Optional source event identifier. - `source_metadata` object, nullable: Optional provider reconciliation metadata. - `value` string, required: Exact decimal value, serialized as a string. - `value_type` 'HISTORICAL' | 'ESTIMATED', required: Whether a resolved highlight value is observed or estimated. - `source` string, required: Publisher/provider name. - `source_url` string, nullable: Source URL, when available. - `unit` 'USD' | 'PERCENT' | 'COUNT' | 'RANK', required: Unit for a resolved highlight metric. - `narrative_sections` CompanyNarrativeSection[]: Ordered durable company fact and thesis blocks. - `body` string, required: Plain-text section body. - `citation_ids` string[]: Profile-local citation ids supporting this block. - `display_order` integer, required: Stable display position within the profile. - `title` string, required: Section heading. - `overview` string, nullable: Long company overview. - `people` CompanyPerson[]: Key people and their roles. - `external_id` string, nullable: Optional source identifier retained for reconciliation. - `name` string, required: Display name. - `roles` CompanyPersonRole[]: One or more curated company roles. - `social` CompanySocialLink[]: Social/profile links. - `type` 'WEBSITE' | 'LINKEDIN' | 'X' | 'FACEBOOK' | 'OTHER', required: Kind of company social/profile link. - `url` string, required: Link URL. - `tagline` string, nullable: Short durable positioning line used with the company name. - `profile_schema_version` integer, required: Profile schema version discriminator. - `published_at` string, date-time, nullable: Publication time. - `short_description` string, required: Short card/search description. - `slug` string, required: Lowercase URL slug. ## Other responses - `401`: Unauthenticated - `403`: Caller lacks account access, or the account holder has not attested - `404`: Account not found, or company not found or not published - `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/companies/:company_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)