---
title: "Get a company by UUID"
method: GET
path: "/v1/companies/{uuid}"
---

# Get a company by UUID

`GET /v1/companies/{uuid}`

## Request

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

## Path parameters

- `uuid` string, uuid, required

## Response `200`

Single company

- Company: Fake company with 100+ fields grouped into logical blocks selectable via the `fields=` query param.
  - `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
- `404`: Company not found

---

[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)