---
title: "List random companies"
method: GET
path: "/v1/companies"
---

# List random companies

`GET /v1/companies`

## Request

- Base URL: `https://random-profiles.com`
- URL: `https://random-profiles.com/v1/companies`
- Auth: API key in header `X-API-Key`

## Query parameters

- `count` integer
- `fields` string
- `logo_size` '64' | '128' | '256' | '512' | '1024'
- `logo_format` 'jpg' | 'webp'
- `industry` string
- `country` string
- `size` string
- `seed` integer
- `format` 'json' | 'csv'

## Response `200`

List of companies

- object
  - `companies` Company[]
    - `uuid` string, uuid
    - `name` string
    - `legal_name` string
    - `legal_form` string: Jurisdiction-specific legal form.
    - `slug` string
    - `domain` string
    - `description` string
    - `tagline` string
    - `industry` 'Technology' | 'Healthcare' | 'Finance' | 'Education' | 'Manufacturing' | 'Retail' | 'Media' | 'Consulting' | 'Real Estate' | 'Transportation' | 'Energy' | 'Telecommunications' | 'Hospitality' | 'Agriculture' | 'Legal' | 'Construction'
    - `sub_industry` string
    - `type` 'private' | 'public' | 'nonprofit'
    - `size` '1-10' | '11-50' | '51-200' | '201-500' | '501-1000' | '1001-5000' | '5000+'
    - `tags` string[]
    - `location` object
      - `street` string
      - `city` string
      - `state` string
      - `country` string
      - `country_name` string
      - `latitude` number
      - `longitude` number
      - `timezone` string
      - `locations` object[]
        - `city` string
        - `country` string
    - `contact` object
      - `phone` string
      - `fax` string, nullable
      - `toll_free` string, nullable
      - `email` string, email
      - `support_email` string, email
      - `sales_email` string, email
      - `press_email` string, email
      - `website` string, uri
      - `languages` string[]
    - `social` object
      - `twitter` string
      - `linkedin` string
      - `github` string
      - `facebook` string
      - `instagram` string
      - `youtube` string
      - `tiktok` string
      - `mastodon` string
      - `bluesky` string
      - `crunchbase` string
    - `financial` object
      - `revenue_range` string
      - `revenue_usd` number
      - `funding_total` number, nullable
      - `valuation` number, nullable
      - `market_cap` number, nullable
      - `ebitda` number
      - `profit_margin` number
      - `currency` string
      - `stock_ticker` string, nullable
      - `ipo_date` string, date, nullable
      - `last_round` string, nullable
      - `investors` string[]
      - `funding_rounds` object[]
        - `round` string
        - `amount` number
        - `date` string, date
        - `lead_investor` string
      - `fiscal_year_end` string
    - `tech` object
      - `tech_stack` string[]
      - `frontend` string[]
      - `backend` string[]
      - `database` string[]
      - `cloud` string[]
      - `analytics` string[]
      - `security_certifications` string[]
      - `api_docs_url` string, uri
      - `status_page_url` string, uri
    - `leadership` object
      - `ceo_name` string
      - `ceo_email` string, email
      - `cfo_name` string
      - `cto_name` string
      - `coo_name` string
      - `founder_names` string[]
    - `legal` object
      - `tax_id` string
      - `vat_number` string, nullable
      - `duns_number` string
      - `registration_number` string
      - `lei` string
      - `incorporation_state` string
    - `operations` object
      - `status` 'active' | 'acquired' | 'defunct'
      - `is_active` boolean
      - `parent_company` string, nullable
      - `acquired_by` string, nullable
      - `acquired_date` string, date, nullable
      - `subsidiaries` string[]
      - `remote_policy` 'remote-first' | 'hybrid' | 'on-site' | 'distributed'
    - `product` object
      - `products` string[]
      - `services` string[]
      - `target_market` string
      - `customer_count` integer
      - `nps_score` integer
      - `competitors` string[]
    - `relationships` object
      - `employee_uuids` string[]: Up to 30 profile UUIDs assigned to this company. Hydrate via /v1/profiles/:uuid.
    - `meta` object
      - `logo_url` string, uri
      - `avatar_url` string, uri
      - `cover_color` string
      - `created_at` string, date-time
      - `updated_at` string, date-time

## Other responses

- `401`: Invalid or missing API key
- `429`: Daily request limit reached

---

[API](https://skmtc.dev/random-profiles/apis/random-profiles-api.md) · [All operations](https://skmtc.dev/random-profiles/apis/random-profiles-api/llms.txt) · [OpenAPI document](https://skmtc.dev/random-profiles/apis/random-profiles-api/revisions/ccbd86a234e6?raw)