> ## 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.

# Entity

> Field reference for the Entity object.

The unified organization/person record returned by company, university, government & NGO, investor, and people endpoints. `type` and `organization_subtype` distinguish the concrete kind.

| Field                      | Type                                                        | Description                                                                                                                                                                                                                             |
| -------------------------- | ----------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `uuid`                     | string                                                      | Stable UUID of the entity. This is the sole public identifier; numeric ids are not accepted on any entity endpoint.                                                                                                                     |
| `type`                     | string (organization, person) (nullable)                    | Top-level entity type — exactly one of `organization` or `person`. For organizations, `organization_subtype` carries the specific kind (company / university / gov\_ngo / investor). Persons always have a null `organization_subtype`. |
| `organization_subtype`     | string (company, university, gov\_ngo, investor) (nullable) | Organization subtype — one of `company`, `university`, `gov_ngo`, `investor`. Mutually exclusive. Set only when `type` is `organization`; always null for persons.                                                                      |
| `is_investor`              | boolean (nullable)                                          | Stackable role flag — true when the entity makes investments. Independent of `type` / `organization_subtype`.                                                                                                                           |
| `is_founder`               | boolean (nullable)                                          | Stackable role flag — true when the person has a founder role. Person-level rollup; always false for organizations.                                                                                                                     |
| `is_executive`             | boolean (nullable)                                          | Stackable role flag — true when the person holds an executive role. Person-level rollup; always false for organizations.                                                                                                                |
| `is_partner`               | boolean (nullable)                                          | Stackable role flag — true when the person holds a partner role (e.g. at an investment firm). Person-level rollup; always false for organizations.                                                                                      |
| `total_invested`           | number (nullable)                                           | Precomputed total amount this entity has invested across all rounds, in whole units of the active currency. Non-null only for entities that make investments (`is_investor = true`); null otherwise.                                    |
| `name`                     | string                                                      | Display name of the entity.                                                                                                                                                                                                             |
| `tagline`                  | string (nullable)                                           | Short, one-line marketing description (≤ \~140 chars).                                                                                                                                                                                  |
| `about`                    | string (nullable)                                           | Long-form description / about text. Plain text, may span multiple sentences.                                                                                                                                                            |
| `image`                    | string (nullable)                                           | Absolute URL to the entity's logo image (PNG or JPEG, CDN-hosted).                                                                                                                                                                      |
| `dealroom_url`             | string (nullable)                                           | Canonical URL on app.dealroom.co.                                                                                                                                                                                                       |
| `closing_year`             | number (nullable)                                           | Year the entity was closed/shut down (null when still active).                                                                                                                                                                          |
| `employee_count`           | number (nullable)                                           | Number of employees.                                                                                                                                                                                                                    |
| `employee_count_1y_growth` | number (nullable)                                           | Year-over-year employee count growth percentage.                                                                                                                                                                                        |
| `launch_year`              | number (nullable)                                           | Year the entity was founded.                                                                                                                                                                                                            |
| `launch_month`             | number (nullable)                                           | Month the entity was founded (1-12; null when unknown).                                                                                                                                                                                 |
| `hq_country`               | string (nullable)                                           | Country name of the entity's HQ.                                                                                                                                                                                                        |
| `hq_city`                  | string (nullable)                                           | City of the entity's HQ.                                                                                                                                                                                                                |
| `website`                  | string (nullable)                                           | Full website URL.                                                                                                                                                                                                                       |
| `website_domain`           | string (nullable)                                           | Domain name only (e.g. "stripe.com").                                                                                                                                                                                                   |
| `linkedin_url`             | string (nullable)                                           | LinkedIn profile URL.                                                                                                                                                                                                                   |
| `twitter_url`              | string (nullable)                                           | Twitter/X profile URL.                                                                                                                                                                                                                  |
| `lat`                      | number (nullable)                                           | HQ latitude in decimal degrees.                                                                                                                                                                                                         |
| `lon`                      | number (nullable)                                           | HQ longitude in decimal degrees.                                                                                                                                                                                                        |
| `founding_country`         | string (nullable)                                           | Country name where the entity was founded.                                                                                                                                                                                              |
| `founding_city`            | string (nullable)                                           | City where the entity was founded.                                                                                                                                                                                                      |
| `founding_lat`             | number (nullable)                                           | Founding location latitude in decimal degrees.                                                                                                                                                                                          |
| `founding_lon`             | number (nullable)                                           | Founding location longitude in decimal degrees.                                                                                                                                                                                         |
| `company`                  | object                                                      | Company-specific attributes. Present only when `organization_subtype = company`. `company_status` is one of `operational`, `acquired`, `closed`, `low_activity`.                                                                        |
| `person`                   | object                                                      |                                                                                                                                                                                                                                         |
| `investor`                 | object                                                      |                                                                                                                                                                                                                                         |
| `university`               | object                                                      |                                                                                                                                                                                                                                         |
| `funding_summary`          | object                                                      | Aggregated funding totals for the entity. Present on companies that have at least one recorded funding round.                                                                                                                           |
| `tags`                     | array of object                                             |                                                                                                                                                                                                                                         |
| `founders`                 | array of object                                             |                                                                                                                                                                                                                                         |
| `latest_valuation`         | object                                                      |                                                                                                                                                                                                                                         |
| `latest_revenue`           | object                                                      |                                                                                                                                                                                                                                         |
| `added_at`                 | string (nullable)                                           | ISO 8601 timestamp when this entity was created in Dealroom's source system ("added to Dealroom"). Distinct from created\_at (data-loader sync time). Sort with `-added_at` for a newest-added-first feed.                              |
| `created_at`               | string (nullable)                                           | ISO 8601 timestamp when this record was first loaded                                                                                                                                                                                    |
| `updated_at`               | string (nullable)                                           | ISO 8601 timestamp when this record was last modified                                                                                                                                                                                   |
| `deleted_at`               | string (nullable)                                           | ISO 8601 timestamp when this record was soft-deleted (null = active)                                                                                                                                                                    |