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

Get Company

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.

Path ParametersExpand Collapse
company_id: string
Query ParametersExpand Collapse
account_id: number

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

formatint64
ReturnsExpand Collapse
data: CompanyDetail { id, name, profile, 6 more }

A company’s identity and its complete published profile.

id: string

Stable company identifier.

formatuuid
name: string

Display name.

profile: CompanyProfileResource { 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.

formatdate-time
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: 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: string

Display title.

url: string

Document URL.

external_id: optional string

Optional source identifier retained for reconciliation.

preview: optional CompanyDocumentPreview { 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.

formatdate-time
headquarters: optional CompanyHeadquarters { 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: MetricFrequency

Observation cadence.

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

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: string

Publisher/provider name.

Value unit.

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

formatdate-time
value: string

Exact decimal value, serialized as a string.

value_type: MetricValueType

Historical or estimated classification.

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

formatint32
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.

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

Social/profile links.

Link type.

One of the following:

Link URL.

tagline: optional string

Short durable positioning line used with the company name.

profile_schema_version: number

Profile schema version discriminator.

formatint32
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.

formatdate-time

Get Company

curl https://api.clearstreet.com/v1/private-markets/companies/$COMPANY_ID \
    -H "Authorization: Bearer $API_KEY"
{
  "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"
  }
}