---
title: "Get a company"
method: GET
path: "/v1/companies/{company}"
tags: ["Companies"]
---

# Get a company

`GET /v1/companies/{company}`

## Request

- Base URL: `http://api.technooptimist.io`
- URL: `http://api.technooptimist.io/v1/companies/{company}`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `api_key`

The company page model: profile, frontiers, programs with next milestones, approach, people, funding, relationships, research, catalysts, instruments, peers.

## Path parameters

- `company` string, required

## Response `200`

Company page

- CompanyPage
  - `company` object, required
    - `slug` string, required
    - `name` string, required
    - `keywords` string, required
    - `description` string, required
    - `website` string, nullable, required
    - `hq` string[], required
    - `foundedYear` number, nullable, required
    - `status` string, required
    - `parent` string, nullable, required
    - `ticker` string, nullable, required
    - `exchange` string, nullable, required
    - `employees` number, nullable, required
    - `employeesAsOf` string, date, nullable, required
    - `valuationUsd` number, nullable, required
    - `valuationKind` 'market_cap' | 'private_valuation' | 'deal_value' | 'none', required
    - `valuationAsOf` string, date, nullable, required
    - `valuationProvenance` 'reported' | 'estimated' | 'sample', nullable, required
    - `score` number, nullable, required
    - `logoUrl` string, nullable, required
    - `brief` string[], required
    - `lastUpdateAt` string, date-time, nullable, required
    - `checkedAt` string, date-time, nullable, required: When we last verified these facts (null = never stamped).
  - `frontiers` object[], required
    - `slug` string, required
    - `name` string, required
    - `field` object, nullable, required
      - `slug` string, required
      - `name` string, required
    - `isPrimary` boolean, required
  - `programs` object[], required
    - `slug` string, required
    - `name` string, required
    - `keywords` string, required
    - `description` string, required
    - `statusLine` string, required
    - `stage` 'research' | 'proto' | 'pilot' | 'deploy' | 'scaling', required
    - `isFlagship` boolean, required
    - `imageUrl` string, nullable, required
    - `frontier` object, required
      - `slug` string, required
      - `name` string, required
    - `path` string, required: Canonical site path. Programs live under their frontier.
    - `milestones` object, required
      - `done` integer, required
      - `total` integer, required
    - `next` object, nullable, required
      - `title` string, required
      - `status` 'done' | 'current' | 'planned' | 'missed', required
      - `date` LooseDate, nullable, required
        - `date` string, date, required
        - `precision` 'day' | 'month' | 'quarter' | 'year', required
      - `slipMonths` number, nullable, required
    - `lastUpdateAt` string, date-time, nullable, required
  - `approach` object[], required
    - `label` string, nullable, required
    - `title` string, required
    - `body` string, required
  - `problems` object[], required
    - `title` string, required
    - `body` string, required
    - `status` 'open' | 'active_research' | 'partially_solved' | 'solved', nullable, required
  - `people` object[], required
    - `name` string, required
    - `role` string, required
    - `url` string, uri, nullable, required
  - `funding` object[], required
    - `date` string, date, required
    - `precision` 'day' | 'month' | 'quarter' | 'year', required
    - `round` string, required
    - `amountUsd` number, nullable, required
    - `postMoneyUsd` number, nullable, required
    - `leads` string[], required
    - `provenance` 'reported' | 'estimated' | 'sample', required
  - `relationships` object[], required
    - `name` string, required
    - `kind` 'customer' | 'investor' | 'supplier' | 'partner' | 'acquirer', required
    - `note` string, nullable, required
    - `url` string, uri, nullable, required
    - `companySlug` string, nullable, required
  - `research` object[], required
    - `date` string, date, required
    - `precision` 'day' | 'month' | 'quarter' | 'year', required
    - `kind` 'paper' | 'blog' | 'demo' | 'talk' | 'dataset' | 'code', required
    - `title` string, required
    - `why` string, required
    - `url` string, uri, nullable, required
    - `program` object, nullable, required
      - `slug` string, required
      - `name` string, required
      - `frontier` string, required
      - `path` string, required: Canonical site path. Programs live under their frontier.
  - `catalysts` object[], required
    - `title` string, required
    - `date` string, date, required
    - `precision` 'day' | 'month' | 'quarter' | 'year', required
    - `kind` string, nullable, required
    - `program` object, nullable, required
      - `slug` string, required
      - `name` string, required
      - `frontier` string, required
      - `path` string, required: Canonical site path. Programs live under their frontier.
  - `instruments` object[], required
    - `symbol` string, required
    - `kind` 'stock' | 'preipo_perp', required
    - `price` number, nullable, required
    - `changePct` number, nullable, required
  - `peers` object[], required
    - `slug` string, required
    - `name` string, required
    - `hq` string[], required
    - `valuationUsd` number, nullable, required
    - `valuationKind` string, required
    - `flagship` object, nullable, required
      - `slug` string, required
      - `name` string, required
      - `stage` 'research' | 'proto' | 'pilot' | 'deploy' | 'scaling', required

## Other responses

- `401`: Missing or invalid credentials
- `404`: Not found
- `429`: Rate limited

---

[API](https://skmtc.dev/technooptimist/apis/the-techno-optimist-api.md) · [All operations](https://skmtc.dev/technooptimist/apis/the-techno-optimist-api/llms.txt) · [OpenAPI document](https://skmtc.dev/technooptimist/apis/the-techno-optimist-api/revisions/b7bcde6a0f30?raw)