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

Get Company

$ clst v1:private-markets get-company-by-id
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: string

Company identifier.

--account-id: number

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

ReturnsExpand Collapse
V1PrivateMarketGetCompanyByIDResponse: BaseResponse { metadata, error }
data: object { id, name, profile, 6 more }

A company’s identity and its complete published profile.

id: string

Stable company identifier.

name: string

Display name.

profile: object { categories, citations, customers, 9 more }

The complete versioned company profile.

categories: optional array of CompanyCategory { name, slug }

Company categories.

name: string

Display name.

slug: string

Stable lowercase category slug.

citations: optional array of CompanyCitation { id, source, title, 2 more }

Sources referenced by narrative sections and metrics.

id: string

Stable profile-local citation identifier.

source: string

Source publisher or provider.

title: string

Human-readable source title.

url: string

Source URL.

published_at: optional string

Source publication time, when known.

customers: optional array of CompanyCustomer { name, logo_url }

Named customers evidenced by the source material.

name: string

Customer name.

logo_url: optional string

Customer logo, when supplied.

documents: optional array of CompanyDocumentResource { document_type, relation, title, 4 more }

Company-level research and source documents.

document_type: "COMPANY_PROFILE" or "MARKET_RESEARCH" or "INTERVIEW" or 4 more

Typed document kind.

"COMPANY_PROFILE"
"MARKET_RESEARCH"
"INTERVIEW"
"DEAL_SHEET"
"PRESS_RELEASE"
"NEWS"
"OTHER"
relation: "SUBJECT" or "CONNECTED"

Relationship to this company.

"SUBJECT"
"CONNECTED"
title: string

Display title.

url: string

Document URL.

external_id: optional string

Optional source identifier retained for reconciliation.

preview: optional object { description, image_url }

Optional card preview.

description: optional string

Preview description.

image_url: optional string

Preview image URL.

published_at: optional string

Publication time, when known.

headquarters: optional object { city, country }

Company headquarters, when known.

city: string

City.

country: string

Country.

Known legal entities associated with the company.

Country name or ISO country code supplied by the source.

Legal name.

metric_series: optional array of CompanyMetricSeries { frequency, label, metric_key, 5 more }

Historical and estimated metric series.

frequency: "YEAR" or "QUARTER" or "MONTH" or "POINT_IN_TIME"

Observation cadence.

"YEAR"
"QUARTER"
"MONTH"
"POINT_IN_TIME"
label: string

Display label.

metric_key: "ANNUALIZED_REVENUE" or "REVENUE_GROWTH" or "VALUATION" or 12 more

Canonical 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"
source: string

Publisher/provider name.

unit: "USD" or "PERCENT" or "COUNT" or "RANK"

Value unit.

"USD"
"PERCENT"
"COUNT"
"RANK"
external_id: optional string

Optional source identifier retained for reconciliation.

points: optional array of CompanyMetricPoint { observed_at, value, value_type, 3 more }

Ordered observations.

observed_at: string

Observation time.

value: string

Exact decimal value, serialized as a string.

value_type: "HISTORICAL" or "ESTIMATED"

Historical or estimated classification.

"HISTORICAL"
"ESTIMATED"
citation_ids: optional array of string

Profile-local citation ids supporting this point.

source_event_id: optional string

Optional source event identifier.

source_metadata: optional map[string]

Optional provider reconciliation metadata.

source_url: optional string

Source URL, when available.

narrative_sections: optional array of CompanyNarrativeSection { body, display_order, title, citation_ids }

Ordered durable company fact and thesis blocks.

body: string

Plain-text section body.

display_order: number

Stable display position within the profile.

title: string

Section heading.

citation_ids: optional array of string

Profile-local citation ids supporting this block.

overview: optional string

Long company overview.

people: optional array of CompanyPerson { name, external_id, roles }

Key people and their roles.

name: string

Display name.

external_id: optional string

Optional source identifier retained for reconciliation.

roles: optional array of CompanyPersonRole

One or more curated company roles.

"FOUNDER"
"CEO"
"OTHER"
social: optional array of CompanySocialLink { type, url }

Social/profile links.

Link type.

"WEBSITE"
"LINKEDIN"
"X"
"FACEBOOK"
"OTHER"

Link URL.

tagline: optional string

Short durable positioning line used with the company name.

profile_schema_version: number

Profile schema version discriminator.

short_description: string

Short card/search description.

slug: string

Lowercase URL slug.

logo_url: optional string

Company logo URL, when known.

primary_domain: optional string

Canonical lowercase domain, when known.

published_at: optional string

Publication time.

Get Company

clst v1:private-markets get-company-by-id \
  --api-key 'My API Key' \
  --company-id 182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e \
  --account-id 0
{
  "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"
  }
}