> ## Documentation Index
> Fetch the complete documentation index at: https://developers.dealroom.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Company

> Field reference for the Company object.

A company profile — the startup, scale-up or corporate itself, with its funding, valuation, team and traction.

Returned by:

* `GET /data/companies`
* `GET /data/companies/{id}`
* `GET /data/companies/{id}/similar`
* `GET /data/investors` (one variant; narrow on `type` and `subtype`)
* `GET /data/investors/{id}` (one variant; narrow on `type` and `subtype`)
* `GET /data/investors/{id}/similar` (one variant; narrow on `type` and `subtype`)

**uuid** `string` *required*

Stable UUID of the entity; the sole public identifier. Example: `"345d1ab6-33df-4759-9e17-0d0c0ec9ab1c"`.

**type** `string (organization)` *required*

Top-level entity type — exactly one of `organization` or `person`. For organizations, `subtype` carries the specific kind (company / university / gov\_ngo / investor). Persons always have a null `subtype`.

**domain** `string | null` *required*

Registrable domain, e.g. "stripe.com". Example: `"stripe.com"`.

**name** `string` *required*

Display name. Example: `"Stripe"`.

**tagline** `string | null` *required*

One-line description.

**about** `string | null` *required*

Long-form description.

**image** `string | null` *required*

Absolute logo URL.

**dealroom\_url** `string | null` *required*

Canonical profile URL on app.dealroom.co.

**links** `object` *required*

The entity's own presence on the web; each null when unknown.

**links**

**website** `string | null` *required*

Website URL.

**linkedin** `string | null` *required*

LinkedIn profile URL.

**twitter** `string | null` *required*

Twitter / X profile URL.

**instagram** `string | null` *required*

Instagram URL or handle.

**angellist** `string | null` *required*

AngelList URL or handle.

**crunchbase** `string | null` *required*

Crunchbase profile URL.

**locations** `object[]` *required*

Every location: hq, founding, then offices; empty when none.

**locations**

**role** `LocationRole` *required*

`hq`, `founding` or `office`. An entity has at most one `hq` and one `founding` location, and any number of offices.

**city** `object | null` *required*

City; null when not known.

**city**

**id** `number` *required*

Location id, as accepted by the location filters.

**name** `string` *required*

Location name.

**state** `object | null` *required*

State or region; null when none.

**state**

**id** `number` *required*

Location id, as accepted by the location filters.

**name** `string` *required*

Location name.

**country** `object | null` *required*

Country.

**country**

**id** `number` *required*

Location id, as accepted by the location filters.

**name** `string` *required*

Location name.

**continent** `object | null` *required*

Continent.

**continent**

**id** `number` *required*

Location id, as accepted by the location filters.

**name** `string` *required*

Location name.

**lat** `number | null` *required*

Entity coordinates when known, otherwise the city centroid.

**lon** `number | null` *required*

Entity coordinates when known, otherwise the city centroid.

**roles** `EntityRole[]` *required*

Roles the organization plays: `investor`, `limited_partner`, `fund_manager`.

**taxonomy** `object[]` *required*

Taxonomy terms (industries, sectors, technologies, …); empty when none.

**taxonomy**

**id** `number` *required*

Numeric identifier of the tag.

**name** `string` *required*

Display name of the tag.

**type** `TagType` *required*

Category of a tag (e.g. industry, sector, technology).

**launch\_date** `PartialDate | null` *required*

When the organization was founded, at source precision.

**closing\_date** `PartialDate | null` *required*

When the organization closed; null while active.

**employees\_count** `number | null` *required*

Number of employees.

**added\_at** `string | null` *required*

When the organization was added to Dealroom (RFC 3339). Format: date-time.

**updated\_at** `string | null` *required*

When this record's data last changed (RFC 3339): the time Dealroom's data pipeline first saw the change, including changes to its tags, locations, team and funding rounds. Null when nothing has changed since tracking began on 2026-11-05. A change can reach the API up to about 6 hours after this time, so overlap incremental pulls by about 6 hours. Bulk data imports can move many records at once. Format: date-time.

**subtype** `string (company)` *required*

Organization subtype — one of `company`, `university`, `gov_ngo`, `investor`. Mutually exclusive. Always null for persons.

**classifications** `Classification[]` *required*

Dealroom labels; empty when none.

**employee\_count\_1y\_growth** `number | null` *required*

Year-over-year employee growth, %.

**status** `CompanyStatus | null` *required*

Operational status.

**signal\_rating** `number | null` *required*

Dealroom Signal rating (0-100).

**unicorn\_type** `string | null` *required*

Unicorn tier, e.g. "unicorn", "decacorn".

**became\_unicorn\_date** `PartialDate | null` *required*

When the company reached a \$1B valuation.

**became\_thoroughbred\_date** `PartialDate | null` *required*

When the company was verified as a Thoroughbred.

**exit\_date** `PartialDate | null` *required*

When the company exited (IPO or acquisition).

**investor** `object | null` *required*

The organization's investing profile; null unless it invests.

**investor**

**rank** `number | null` *required*

Dealroom investor ranking (1 = top). Full view only.

**types** `object[]` *required*

Investor types; empty when none.

**types**

**id** `number` *required*

Tag id.

**name** `string` *required*

Display name.

**code** `string` *required*

Machine-readable code.

**stages** `object[]` *required*

Stages invested in; empty when none.

**stages**

**id** `number` *required*

Tag id.

**name** `string` *required*

Display name.

**code** `string` *required*

Machine-readable code.

**deal\_size** `object | null` *required*

Ticket size range; null when unknown.

**deal\_size**

**min** `number | null` *required*

Smallest ticket, active currency.

**max** `number | null` *required*

Largest ticket, active currency.

**investments** `object` *required*

Investment activity.

**investments**

**count** `number | null` *required*

Investments made.

**total\_invested** `number | null` *required*

Total size of the funding rounds the investor participated in (the full round amounts, not the investor's own ticket), active currency.

**preferred\_round** `string | null` *required*

Most frequent round stage, e.g. `series_a`.

**last\_round\_date** `PartialDate | null` *required*

Date of the most recent funding round the investor participated in (acquisitions, IPOs and other exits excluded), at source precision.

**portfolio** `object | null` *required*

Companies backed; detail on the `/portfolio` sub-resource. Full view only.

**portfolio**

**rounds\_count** `number | null` *required*

Funding rounds taken part in.

**total\_valuation** `number | null` *required*

Combined latest valuation of the companies backed, active currency.

**companies** `object` *required*

Companies backed: the first 10 of `/investors/{id}/portfolio`.

**companies**

**total** `integer` *required*

How many exist in total, including those `items` leaves out.

**sort** `string (-last_round_date)` *required*

The order of `items`, in the sub-resource's `sort` syntax.

**items** `object[]` *required*

A capped preview: the first items in `sort` order. When it holds fewer than `total`, page the full list from the sub-resource named above.

**items**

**is\_lead** `boolean` *required*

Led at least one of these rounds.

**rounds\_count** `integer` *required*

Rounds taken part in.

**last\_round\_date** `PartialDate | null` *required*

Date of the most recent of those rounds, at source precision.

**company** `EntityRef` *required*

The identity of an entity embedded in another entity's response. Closed: richer detail lives on the sub-resource, where tier redaction can reach it.

**company**

**uuid** `string` *required*

Stable UUID of the entity.

**type** `EntityType` *required*

Top-level entity type: `organization` or `person`.

**subtype** `OrganizationSubtype | null` *required*

Organization subtype; always null for a person.

**name** `string` *required*

Display name.

**image** `string | null` *required*

Absolute image URL; null when none.

**dealroom\_url** `string | null` *required*

Canonical profile URL on app.dealroom.co.

**exits** `object | null` *required*

Portfolio exits. Full view only.

**exits**

**count** `number | null` *required*

Portfolio companies whose link to the investor is flagged exited.

**total\_value** `number | null` *required*

Combined value of the exited companies' acquisitions, buyouts and IPOs, active currency.

**pct** `number | null` *required*

Exits as a share of the portfolio, rounded up to a whole percent; 0 when the portfolio has fewer than 10 companies.

**match** `object | null` *required*

Portfolio companies matching the request's `portfolio_count_*` filters; null when the request carries none. Full view only.

**match**

**companies\_count** `number | null` *required*

Portfolio companies matching the request's portfolio filters.

**invested** `number | null` *required*

Invested in those companies, active currency.

**round\_match** `object | null` *required*

Funding rounds matching the request's round\_filter, out of the investor's funding rounds; null unless the request sets round\_filter or include\_round\_match. Full view only.

**round\_match**

**count** `integer` *required*

Funding rounds matching `round_filter`.

**total** `integer` *required*

The investor's funding rounds in the period that `round_filter`'s Round Date (`date`) and Round Year (`year`) conditions set at its top level; every funding round when there are none.

**pct** `number | null` *required*

count / total, as a percentage; null when total is 0.

**funding** `object | null` *required*

Funding raised; null when no round is recorded.

**funding**

**total** `number | null` *required*

Total raised, active currency.

**total\_vc** `number | null` *required*

VC-only share of `total`.

**rounds\_count** `number | null` *required*

Funding rounds recorded.

**valuation** `object | null` *required*

Most recent valuation, with the period it applies to.

**valuation**

**value** `number | null` *required*

Latest valuation, active currency.

**year** `number | null` *required*

Year the valuation was recorded.

**month** `number | null` *required*

Month (1-12); null when unknown.

**jobs** `object` *required*

Hiring status and open roles.

**jobs**

**is\_hiring** `boolean | null` *required*

Currently recruiting.

**open\_count** `number` *required*

Active job openings; 0 when none.

**revenue** `object | null` *required*

Most recent revenue.

**revenue**

**value** `number | null` *required*

Latest revenue, active currency.

**year** `number | null` *required*

Year the revenue applies to.

**traffic** `object | null` *required*

Web traffic (SimilarWeb).

**traffic**

**monthly\_visits** `number | null` *required*

Monthly site visits.

**growth\_3m** `number | null` *required*

Change in monthly website visits between the latest month and two months before it, in %.

**patents** `object | null` *required*

Valued patents (PatSnap); detail on the `/patents` sub-resource.

**patents**

**count** `number | null` *required*

Valued patents (PatSnap).

**founders** `object` *required*

Current founders: the first 5 of `/{collection}/{id}/team?role=founder&is_past=false&sort=-is_strong_founder,-signal_rating`, strong founders first, so the cap never drops the founder a strong-founder filter matched.

**founders**

**total** `integer` *required*

How many exist in total, including those `items` leaves out.

**sort** `string (-is_strong_founder,-signal_rating)` *required*

The order of `items`, in the sub-resource's `sort` syntax.

**items** `object[]` *required*

A capped preview: the first items in `sort` order. When it holds fewer than `total`, page the full list from the sub-resource named above.

**items**

**raw\_title** `string | null` *required*

Job title as recorded.

**titles** `string[]` *required*

Normalized job titles.

**is\_founder** `boolean` *required*

Founded the organization.

**is\_executive** `boolean` *required*

Holds an executive role there.

**is\_partner** `boolean` *required*

Holds a partner role there.

**is\_past** `boolean` *required*

Every role there has ended.

**start\_date** `PartialDate | null` *required*

When the first role there started, at source precision.

**end\_date** `PartialDate | null` *required*

When the last role there ended; null while any is current.

**person** `FounderRef` *required*

An `EntityRef` plus the founder labels the founders glance is ordered by.

**available** `CompanyFullBlock[]` *required*

Full-only blocks that hold data for this row, listed even when the caller's tier withholds them.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.