Skip to content
Clear Street Clear Street Clear Street
Start Trading
API Reference
V1
Private Markets

Get Company

v1.private_markets.get_company_by_id(strcompany_id, PrivateMarketGetCompanyByIDParams**kwargs) -> PrivateMarketGetCompanyByIDResponse
GET/v1/private-markets/companies/{company_id}

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.

ParametersExpand Collapse
company_id: str
account_id: int

Account whose account-holder entity must hold an accreditation attestation to browse private-market offerings.

formatint64
ReturnsExpand Collapse
class PrivateMarketGetCompanyByIDResponse: …

A company’s identity and its complete published profile.

id: str

Stable company identifier.

formatuuid
name: str

Display name.

The complete versioned company profile.

categories: Optional[List[CompanyCategory]]

Company categories.

name: str

Display name.

slug: str

Stable lowercase category slug.

citations: Optional[List[CompanyCitation]]

Sources referenced by narrative sections and metrics.

id: str

Stable profile-local citation identifier.

source: str

Source publisher or provider.

title: str

Human-readable source title.

url: str

Source URL.

published_at: Optional[datetime]

Source publication time, when known.

formatdate-time
customers: Optional[List[CompanyCustomer]]

Named customers evidenced by the source material.

name: str

Customer name.

logo_url: Optional[str]

Customer logo, when supplied.

documents: Optional[List[CompanyDocumentResource]]

Company-level research and source documents.

document_type: CompanyDocumentType

Typed document kind.

One of the following:
"COMPANY_PROFILE"
"MARKET_RESEARCH"
"INTERVIEW"
"DEAL_SHEET"
"PRESS_RELEASE"
"NEWS"
"OTHER"

Relationship to this company.

One of the following:
"SUBJECT"
"CONNECTED"
title: str

Display title.

url: str

Document URL.

external_id: Optional[str]

Optional source identifier retained for reconciliation.

preview: Optional[CompanyDocumentPreview]

Optional card preview.

description: Optional[str]

Preview description.

image_url: Optional[str]

Preview image URL.

published_at: Optional[datetime]

Publication time, when known.

formatdate-time
headquarters: Optional[CompanyHeadquarters]

Company headquarters, when known.

city: str

City.

country: str

Country.

Known legal entities associated with the company.

Country name or ISO country code supplied by the source.

Legal name.

metric_series: Optional[List[CompanyMetricSeries]]

Historical and estimated metric series.

frequency: MetricFrequency

Observation cadence.

One of the following:
"YEAR"
"QUARTER"
"MONTH"
"POINT_IN_TIME"
label: str

Display label.

metric_key: MetricKey

Canonical metric key.

One of the following:
"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"
source: str

Publisher/provider name.

Value unit.

One of the following:
"USD"
"PERCENT"
"COUNT"
"RANK"
external_id: Optional[str]

Optional source identifier retained for reconciliation.

points: Optional[List[CompanyMetricPoint]]

Ordered observations.

observed_at: datetime

Observation time.

formatdate-time
value: str

Exact decimal value, serialized as a string.

value_type: MetricValueType

Historical or estimated classification.

One of the following:
"HISTORICAL"
"ESTIMATED"
citation_ids: Optional[List[str]]

Profile-local citation ids supporting this point.

source_event_id: Optional[str]

Optional source event identifier.

source_metadata: Optional[Dict[str, str]]

Optional provider reconciliation metadata.

source_url: Optional[str]

Source URL, when available.

narrative_sections: Optional[List[CompanyNarrativeSection]]

Ordered durable company fact and thesis blocks.

body: str

Plain-text section body.

display_order: int

Stable display position within the profile.

formatint32
title: str

Section heading.

citation_ids: Optional[List[str]]

Profile-local citation ids supporting this block.

overview: Optional[str]

Long company overview.

people: Optional[List[CompanyPerson]]

Key people and their roles.

name: str

Display name.

external_id: Optional[str]

Optional source identifier retained for reconciliation.

roles: Optional[List[CompanyPersonRole]]

One or more curated company roles.

One of the following:
"FOUNDER"
"CEO"
"OTHER"
social: Optional[List[CompanySocialLink]]

Social/profile links.

Link type.

One of the following:

Link URL.

tagline: Optional[str]

Short durable positioning line used with the company name.

profile_schema_version: int

Profile schema version discriminator.

formatint32
short_description: str

Short card/search description.

slug: str

Lowercase URL slug.

logo_url: Optional[str]

Company logo URL, when known.

primary_domain: Optional[str]

Canonical lowercase domain, when known.

published_at: Optional[datetime]

Publication time.

formatdate-time

Get Company

from clearstreet import ClearStreet

client = ClearStreet(
    api_key="My API Key",
)
response = client.v1.private_markets.get_company_by_id(
    company_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    account_id=0,
)
print(response)
{
  "data": {
    "id": "b2b3b4b5-c2c3-d2d3-e2e3-e4e5e6e7e8e9",
    "name": "Acme Robotics",
    "profile": {
      "overview": "Acme Robotics builds autonomous material-handling systems for manufacturers.",
      "tagline": "Automating the factory floor."
    },
    "profile_schema_version": 1,
    "short_description": "Industrial automation.",
    "slug": "acme-robotics"
  },
  "error": null,
  "metadata": {
    "request_id": "7c8d9e0f-1a2b-3c4d-5e6f-7a8b9c0d1e2f"
  }
}
Returns Examples
{
  "data": {
    "id": "b2b3b4b5-c2c3-d2d3-e2e3-e4e5e6e7e8e9",
    "name": "Acme Robotics",
    "profile": {
      "overview": "Acme Robotics builds autonomous material-handling systems for manufacturers.",
      "tagline": "Automating the factory floor."
    },
    "profile_schema_version": 1,
    "short_description": "Industrial automation.",
    "slug": "acme-robotics"
  },
  "error": null,
  "metadata": {
    "request_id": "7c8d9e0f-1a2b-3c4d-5e6f-7a8b9c0d1e2f"
  }
}