---
title: "Get company profiles"
method: POST
path: "/companies"
tags: ["Companies"]
---

# Get company profiles

`POST /companies`

Retrieve company profiles by company ID, LEI, ISIN, or asset ID. Identifier filters are matched with OR semantics and only active companies/assets are returned.

## Request body

- object
  - `company_ids` string[] — Filter by one or more Elbstream company IDs.
  - `leis` string[] — Filter by one or more Legal Entity Identifiers.
  - `isins` string[] — Filter by one or more asset ISINs linked to companies.
  - `asset_ids` string[] — Filter by one or more Elbstream asset IDs linked to companies.
  - `lang` 'en' — Preferred language for localized company fields.

## Response `200`

Successfully retrieved company profiles

- object
  - `data` object[], required — Array of company profiles
    - `id` string, uuid, required — Unique identifier for the company
    - `lei` string, nullable, required — Legal Entity Identifier
    - `names` object, required — Company names
      - `legal` string, nullable, required — Legal name of the company
      - `display` string, nullable, required — Display name of the company
      - `other` object[], required — Active alternative and previous company names
        - `name` string, required — Alternative or previous company name
        - `type` string, required — Alternative name type
    - `description` string, nullable, required — Localized company description
    - `website_url` string, uri, nullable, required — Company website URL
    - `social_urls` object, required
      - `facebook` string, uri, nullable, required
      - `linkedin` string, uri, nullable, required
      - `x` string, uri, nullable, required
      - `instagram` string, uri, nullable, required
      - `tiktok` string, uri, nullable, required
    - `legal_form_code` string, nullable, required — Entity legal form code
    - `jurisdiction` string, nullable, required — Legal jurisdiction code
    - `incorporation_date` string, date, nullable, required — Company incorporation date
    - `ipo_date` string, date, nullable, required — Initial public offering date
    - `employees` integer, nullable, required — Employee count
    - `market_capitalization` object, nullable, required
      - `value` string, required — Market capitalization as a decimal string
      - `currency` string, required — ISO 4217 currency code
    - `gics` object, required
      - `sector` object, nullable, required
        - `id` string, required — GICS classification code
        - `name` string, required — GICS classification name
      - `industry_group` object, nullable, required
        - `id` string, required — GICS classification code
        - `name` string, required — GICS classification name
      - `industry` object, nullable, required
        - `id` string, required — GICS classification code
        - `name` string, required — GICS classification name
      - `sub_industry` object, nullable, required
        - `id` string, required — GICS classification code
        - `name` string, required — GICS classification name
    - `addresses` object, required
      - `legal` object, required
        - `lines` string[], required — Street address lines
        - `city` string, nullable, required — City
        - `region` string, nullable, required — Region or subdivision
        - `country` string, nullable, required — ISO 3166-1 alpha-2 country code
        - `postal_code` string, nullable, required — Postal code
        - `coordinates` object, nullable, required — Geographic coordinates when available
          - `latitude` number, required
          - `longitude` number, required
      - `headquarters` object, required
        - `lines` string[], required — Street address lines
        - `city` string, nullable, required — City
        - `region` string, nullable, required — Region or subdivision
        - `country` string, nullable, required — ISO 3166-1 alpha-2 country code
        - `postal_code` string, nullable, required — Postal code
        - `coordinates` object, nullable, required — Geographic coordinates when available
          - `latitude` number, required
          - `longitude` number, required
    - `assets` object[], required — Active assets linked to this company
      - `id` string, uuid, required — Unique identifier for the asset
      - `type` string, required — Type of the asset
      - `identifier` string, required — ISIN or other primary asset identifier
      - `name` string, required — Display name of the asset
    - `updated_at` string, date-time, required — Last company profile update timestamp

## Other responses

- `400` — Invalid request body
- `401` — Unauthorized - Missing or invalid API key
- `415` — Unsupported Media Type - Content-Type must be application/json

---

[API](https://skmtc.dev/elbstream/apis/elbstream-api.md) · [All operations](https://skmtc.dev/elbstream/apis/elbstream-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/elbstream/elbstream-api/revisions/21aaa5c851aa/schema)