## 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 Parameters

- `company_id: string`

### Query Parameters

- `account_id: number`

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

### Returns

- `data: CompanyDetail`

  A company's identity and its complete published profile.

  - `id: string`

    Stable company identifier.

  - `name: string`

    Display name.

  - `profile: CompanyProfileResource`

    The complete versioned company profile.

    - `categories: optional array of CompanyCategory`

      Company categories.

      - `name: string`

        Display name.

      - `slug: string`

        Stable lowercase category slug.

    - `citations: optional array of CompanyCitation`

      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`

      Named customers evidenced by the source material.

      - `name: string`

        Customer name.

      - `logo_url: optional string`

        Customer logo, when supplied.

    - `documents: optional array of CompanyDocumentResource`

      Company-level research and source documents.

      - `document_type: CompanyDocumentType`

        Typed document kind.

        - `"COMPANY_PROFILE"`

        - `"MARKET_RESEARCH"`

        - `"INTERVIEW"`

        - `"DEAL_SHEET"`

        - `"PRESS_RELEASE"`

        - `"NEWS"`

        - `"OTHER"`

      - `relation: CompanyDocumentRelation`

        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 CompanyDocumentPreview`

        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 CompanyHeadquarters`

      Company headquarters, when known.

      - `city: string`

        City.

      - `country: string`

        Country.

    - `legal_entities: optional array of CompanyLegalEntity`

      Known legal entities associated with the company.

      - `country: string`

        Country name or ISO country code supplied by the source.

      - `name: string`

        Legal name.

    - `metric_series: optional array of CompanyMetricSeries`

      Historical and estimated metric series.

      - `frequency: MetricFrequency`

        Observation cadence.

        - `"YEAR"`

        - `"QUARTER"`

        - `"MONTH"`

        - `"POINT_IN_TIME"`

      - `label: string`

        Display label.

      - `metric_key: MetricKey`

        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: MetricUnit`

        Value unit.

        - `"USD"`

        - `"PERCENT"`

        - `"COUNT"`

        - `"RANK"`

      - `external_id: optional string`

        Optional source identifier retained for reconciliation.

      - `points: optional array of CompanyMetricPoint`

        Ordered observations.

        - `observed_at: string`

          Observation time.

        - `value: string`

          Exact decimal value, serialized as a string.

        - `value_type: MetricValueType`

          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`

      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`

      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`

      Social/profile links.

      - `type: CompanySocialType`

        Link type.

        - `"WEBSITE"`

        - `"LINKEDIN"`

        - `"X"`

        - `"FACEBOOK"`

        - `"OTHER"`

      - `url: string`

        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.

### Example

```http
curl https://api.clearstreet.com/v1/private-markets/companies/$COMPANY_ID \
    -H "Authorization: Bearer $API_KEY"
```

#### Response

```json
{
  "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"
  }
}
```