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

### Parameters

- `--company-id: string`

  Company identifier.

- `--account-id: number`

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

### Returns

- `V1PrivateMarketGetCompanyByIDResponse: BaseResponse`

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

        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: "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.

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

          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`

        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: "WEBSITE" or "LINKEDIN" or "X" or 2 more`

          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

```cli
clst v1:private-markets get-company-by-id \
  --api-key 'My API Key' \
  --company-id 182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e \
  --account-id 0
```

#### 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"
  }
}
```