---
title: "Fetch companies with corresponding data"
method: POST
path: "/companies/fetch"
tags: ["companies"]
---

# Fetch companies with corresponding data

`POST /companies/fetch`

Fetch companies with corresponding data (e.g. tags)

## Request body

- union
  - object
    - `ids` string[], required — The Swarm company IDs
    - `linkedinNames` string[] — LinkedIn company URL slugs
    - `linkedinIds` integer[] — LinkedIn numeric company IDs
    - `fields` string[]
  - object
    - `ids` string[] — The Swarm company IDs
    - `linkedinNames` string[], required — LinkedIn company URL slugs
    - `linkedinIds` integer[] — LinkedIn numeric company IDs
    - `fields` string[]
  - object
    - `ids` string[] — The Swarm company IDs
    - `linkedinNames` string[] — LinkedIn company URL slugs
    - `linkedinIds` integer[], required — LinkedIn numeric company IDs
    - `fields` string[]

## Response `200`

A list of companies with corresponding data

- object
  - `results` Company[], required — List of companies with corresponding data
    - `id` string, uuid, required
    - `company_info` object
      - `id` string
      - `linkedin_slugs` string[]
      - `name` string
      - `alternative_names` string[]
      - `description` string
      - `summary` string
      - `contact_info` object
        - `email` string
        - `phone` string
        - `url` string
      - `canonical_name` string
      - `founded` string, date-time
      - `industry` string
      - `website` string
      - `workforce` object[]
        - `headcount` integer
        - `historical_headcount` object[]
          - `timestamp` integer
          - `count` integer
        - `size_class` string
      - `tech_stack` object
        - `products` string[]
      - `business_data` object
        - `identifiers` object
          - `stock_ticker` string
          - `duns_code` string
          - `cage_code` string
          - `naics_code` string
        - `customer_types` string[]
        - `stock_exchange` string
        - `is_acquired` boolean
        - `is_exited` boolean
        - `is_government` boolean
        - `is_non_profit` boolean
        - `is_shut_down` boolean
        - `is_startup` boolean
        - `is_stealth` boolean
        - `ownership_status` string
        - `ownership_status_detailed` string
        - `patent_count` integer
        - `financing_profile` object
          - `status` string
          - `ipo_date` string, date-time
          - `outstanding_shares` number
          - `market_cap` number
      - `social_media` SocialMedia[] — The networks of the company
        - `network` string — Social media network name
        - `id` string — Identifier on the social network
        - `slug` string — Slug / handle on the social network
        - `url` string — Full profile URL
        - `url_status` '' | 'unknown' | 'active' — Status of the resolved URL
      - `locations` object[]
        - `name` string
        - `country` string
        - `is_primary` boolean
      - `logo_url` string
      - `type` string[]
      - `specialities` string[]
      - `investments` string[]
      - `geography_focus` string[]
      - `funding` object
        - `last_round` object
          - `last_round_type` string
          - `last_round_amount_usd` integer
          - `last_round_date` string, date-time
          - `last_round_investors` object[]
            - `id` string, uuid
            - `kind` 'Unknown' | 'Profile' | 'Company' — Investor kind
            - `name` string
            - `crunchbase_id` string
            - `crunchbase_slug` string
        - `rounds` object[]
          - `type` string
          - `amount_usd` integer
          - `date` string, date-time
          - `investors` object[]
            - `id` string, uuid
            - `kind` 'Unknown' | 'Profile' | 'Company' — Investor kind
            - `name` string
            - `crunchbase_id` string
            - `crunchbase_slug` string
        - `total_funding_amount_usd` integer
      - `updated_at` string, date-time
      - `data_updated_at` string, date-time
      - `industries` string[]
      - `websites` string[]
      - `Size` object
        - `class` string
    - `tags` object[]
      - `id` string, uuid
      - `name` string
    - `found_by` CompanyFoundBy — Which of the requested identifiers matched this result
      - `ids` string[]
      - `linkedinNames` string[]
      - `linkedinIds` integer[]
  - `notFound` string[] — List of company identifiers (ids / linkedinNames / linkedinIds) that were not found

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `5XX` — Unexpected error

---

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