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

### Parameters

- `company_id: str`

- `account_id: int`

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

### Returns

- `class PrivateMarketGetCompanyByIDResponse: …`

  - `data: CompanyDetail`

    A company's identity and its complete published profile.

    - `id: str`

      Stable company identifier.

    - `name: str`

      Display name.

    - `profile: CompanyProfileResource`

      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.

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

          - `"COMPANY_PROFILE"`

          - `"MARKET_RESEARCH"`

          - `"INTERVIEW"`

          - `"DEAL_SHEET"`

          - `"PRESS_RELEASE"`

          - `"NEWS"`

          - `"OTHER"`

        - `relation: CompanyDocumentRelation`

          Relationship to this company.

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

      - `headquarters: Optional[CompanyHeadquarters]`

        Company headquarters, when known.

        - `city: str`

          City.

        - `country: str`

          Country.

      - `legal_entities: Optional[List[CompanyLegalEntity]]`

        Known legal entities associated with the company.

        - `country: str`

          Country name or ISO country code supplied by the source.

        - `name: str`

          Legal name.

      - `metric_series: Optional[List[CompanyMetricSeries]]`

        Historical and estimated metric series.

        - `frequency: MetricFrequency`

          Observation cadence.

          - `"YEAR"`

          - `"QUARTER"`

          - `"MONTH"`

          - `"POINT_IN_TIME"`

        - `label: str`

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

          Publisher/provider name.

        - `unit: MetricUnit`

          Value unit.

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

          - `value: str`

            Exact decimal value, serialized as a string.

          - `value_type: MetricValueType`

            Historical or estimated classification.

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

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

          - `"FOUNDER"`

          - `"CEO"`

          - `"OTHER"`

      - `social: Optional[List[CompanySocialLink]]`

        Social/profile links.

        - `type: CompanySocialType`

          Link type.

          - `"WEBSITE"`

          - `"LINKEDIN"`

          - `"X"`

          - `"FACEBOOK"`

          - `"OTHER"`

        - `url: str`

          Link URL.

      - `tagline: Optional[str]`

        Short durable positioning line used with the company name.

    - `profile_schema_version: int`

      Profile schema version discriminator.

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

### Example

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

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