> ## 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. # List education > The person's education records — degree, majors and years — each with the university as its summary row. Most recent first (`sort=-start_date`), the order the `education` glance on the person row uses. ## OpenAPI ````yaml /openapi.yaml get /data/people/{id}/education openapi: 3.1.0 info: title: Dealroom API version: '2026-10-09' description: >- REST API for the Dealroom platform — companies, funds, founders, investors, funding rounds, valuations, taxonomy, news, and aggregate analytics across all of them. Authentication uses Auth0 (Bearer JWT or OAuth2 client_credentials). All endpoints are versioned via the `API-Version` header (Stripe-style date-based versioning). contact: name: Dealroom API support email: support@dealroom.co url: https://dealroom.co termsOfService: https://dealroom.co/terms license: name: Proprietary — Dealroom commercial license url: https://dealroom.co/terms servers: - url: https://api.dealroom.app description: Production security: - bearerAuth: [] - oauth2: [] tags: - name: Discovery description: API root discovery and functional namespaces. - name: Entities description: >- Companies, investors, people, universities, and other organisations. Filter, sort, and paginate the unified entity index. The term `investor` refers to the investment firm; `fund` refers to the capital vehicle it raises. - name: Companies description: >- Company profiles — the `organization_subtype = company` subset of entities (excludes investors, universities, and gov/NGOs). Same response shape as the entity index, scoped to companies. - name: Universities description: >- University profiles — the `organization_subtype = university` subset of entities. The `university` sub-object carries alumni metrics. - name: Government & NGO description: >- Government bodies and NGOs — the `organization_subtype = gov_ngo` subset of entities. - name: Transactions description: >- Funding rounds, equity events, debt, grants, exits, and other company-level financial events. - name: Valuations description: Company valuation history, by `valued_date`. - name: Investors description: >- Investor profiles (VCs, corporates, angels, family offices, governments). Subset of entities where `is_investor = true`. An investor is the firm that makes investments; the capital vehicles it raises are funds available via `/investors/{id}/funds`. - name: Funds description: >- Funds — the capital vehicles investor firms raise (e.g. "Fund III", $200M, 2024). Browse/filter by manager, type, size, and vintage; each fund links to its manager (GP). Fund size (`amount`) converts to the requested `?currency=` (default USD); `amount_source` carries the original native-currency amount. - name: People description: >- Person profiles (founders, executives, angels, and others). Subset of entities where `entity_type = 'person'`. Same response shape as founders, with company associations, education, and tags. - name: Founders description: >- Founder profiles with company associations and education history. Subset of entities where `is_founder = true`. - name: News description: Curated news articles about companies, funds, deals, sectors, and events. - name: Jobs description: Active job openings posted by companies, with hiring-trend signals. - name: Aggregate description: >- Composable single- and multi-metric aggregations across companies, universities, government bodies and NGOs, funding rounds, valuations, founders, investors, and entities of every type. - name: Timeseries description: Yearly entity metrics (employees, revenue, valuation). - name: Filters description: >- Filter registry discovery and value lookup. Use `/reference/filters` to discover available filters per scope and `/reference/filters/:key/values` to look up valid values. - name: Health description: Liveness probe (public, unauthenticated). - name: Search description: >- Cross-resource fuzzy search across companies, investors, people, universities, and government & NGO bodies. paths: /data/people/{id}/education: get: tags: - People summary: List education description: >- The person's education records — degree, majors and years — each with the university as its summary row. Most recent first (`sort=-start_date`), the order the `education` glance on the person row uses. operationId: personEducation parameters: - schema: type: string minLength: 1 format: uuid example: 345d1ab6-33df-4759-9e17-0d0c0ec9ab1c description: Stable UUID of the entity. Numeric ids are not accepted. required: true description: Stable UUID of the entity. Numeric ids are not accepted. name: id in: path - schema: type: integer format: int32 minimum: 1 maximum: 500 default: 25 description: Number of results to return (1-500, default 25) example: 25 required: false description: Number of results to return (1-500, default 25) name: limit in: query - schema: type: string description: >- Opaque cursor token from a previous response's `page.next_cursor` or `page.prev_cursor`. Round-trip it as-is — do not decode or modify. example: eyJ2IjoxLCJkIjoibmV4dCJ9 required: false description: >- Opaque cursor token from a previous response's `page.next_cursor` or `page.prev_cursor`. Round-trip it as-is — do not decode or modify. name: cursor in: query - schema: type: string pattern: ^(?:-?\w+)?(?:,(?:-?\w+)?)*$ description: >- Sort by one or more keys. Prefix with `-` for descending order; comma-separated for multi-key sorts. example: '-start_date' required: false description: >- Sort by one or more keys. Prefix with `-` for descending order; comma-separated for multi-key sorts. name: sort in: query - schema: type: boolean description: >- Pass `true` to compute `page.total` (the matching record count). By default no count query runs and `page.total` is `null`. example: true required: false description: >- Pass `true` to compute `page.total` (the matching record count). By default no count query runs and `page.total` is `null`. name: include_total in: query - schema: type: string description: >- ISO 4217 currency code for monetary field conversion. Defaults to USD. example: EUR required: false description: >- ISO 4217 currency code for monetary field conversion. Defaults to USD. name: currency in: query - $ref: '#/components/parameters/ApiVersion' responses: '200': description: Person education records content: application/json: schema: $ref: '#/components/schemas/PersonEducationResponse' headers: X-Credits-Used: $ref: '#/components/headers/X-Credits-Used' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' '400': description: Invalid entity ID or request parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: VALIDATION_ERROR message: The request was malformed or failed validation. details: null headers: X-Credits-Used: $ref: '#/components/headers/X-Credits-Used' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' '401': description: >- Authentication required. The `Authorization` header was missing, the bearer token was malformed, or the token failed signature / expiry validation. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: UNAUTHORIZED message: Authentication required — provide a valid bearer token. details: null headers: Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' '402': description: >- `CREDITS_EXHAUSTED` — the caller's team has no credits left, or none granted yet. Only API-key and MCP requests are capped. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' headers: X-Credits-Used: $ref: '#/components/headers/X-Credits-Used' '403': description: >- Authentication succeeded but the caller's token does not include the permission required for this operation. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: FORBIDDEN message: You do not have permission to perform this action. details: null headers: X-Credits-Used: $ref: '#/components/headers/X-Credits-Used' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' '429': description: Rate limit exceeded. headers: X-Credits-Used: $ref: '#/components/headers/X-Credits-Used' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' Retry-After: schema: type: string description: Seconds to wait before retrying. example: '1' required: true description: Seconds to wait before retrying. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: RATE_LIMITED message: >- Rate limit exceeded — retry after the delay in the `Retry-After` header. details: null '503': description: >- `SERVICE_UNAVAILABLE` — the caller's team credits could not be checked. Retry shortly. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: SERVICE_UNAVAILABLE message: The service is temporarily unavailable. details: null headers: X-Credits-Used: $ref: '#/components/headers/X-Credits-Used' security: - oauth2: - read:people - bearerAuth: - read:people components: parameters: ApiVersion: name: API-Version in: header required: false schema: type: string format: date example: '2026-10-09' description: >- Pin a Stripe-style date-based API version (`YYYY-MM-DD`). Omit to use the latest version (`2026-10-09`). A pinned version is supported for 30 days after it is superseded, after which it returns `400`. schemas: PersonEducationResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/PersonEducationItem' page: type: object properties: total: type: - number - 'null' limit: type: number offset: type: number next_cursor: type: - string - 'null' description: >- Opaque cursor for the next page. Null when no further pages exist. prev_cursor: type: - string - 'null' description: >- Opaque cursor for the previous page. Null when on the first page. required: - total - limit - offset - next_cursor - prev_cursor currency: type: string description: >- Currency the participant's monetary fields are expressed in (default USD). example: EUR required: - data - page - currency ErrorResponse: type: object properties: error: type: object properties: code: type: string enum: - VALIDATION_ERROR - NOT_FOUND - UNAUTHORIZED - DATABASE_ERROR - UNKNOWN_FILTER - FILTER_VALIDATION_ERROR - UNSUPPORTED_OPERATOR - FILTER_PARSE_ERROR - QUERY_TIMEOUT - INTERNAL_SERVER_ERROR - INVALID_ENTITY_ID - PAGINATION_DEPTH_EXCEEDED - SCHEMA_ERROR - FORBIDDEN - EXTERNAL_SERVICE_ERROR - ACCOUNT_REQUIRED - INSTANCE_ACCESS_REQUIRED - SERVICE_UNAVAILABLE - RATE_LIMITED - CREDITS_EXHAUSTED - LIST_LOCKED - PATH_RENAMED - ENDPOINT_REMOVED description: Stable machine-readable error code. message: type: string details: anyOf: - type: array items: type: object properties: path: type: string message: type: string required: - path - message - type: object additionalProperties: anyOf: - type: string - type: number - type: boolean - type: 'null' required: - code - message - details required: - error PersonEducationItem: type: object properties: degree: type: - object - 'null' properties: id: type: number description: Numeric id. name: type: string description: Display name. required: - id - name description: Degree obtained, when known. majors: type: array items: type: object properties: id: type: number description: Numeric id. name: type: string description: Display name. required: - id - name description: Fields of study. start_date: anyOf: - $ref: '#/components/schemas/PartialDate' - type: 'null' description: When the studies started. end_date: anyOf: - $ref: '#/components/schemas/PartialDate' - type: 'null' description: When the studies ended. university: $ref: '#/components/schemas/OrganizationSummary' required: - degree - majors - start_date - end_date - university PartialDate: type: string pattern: ^\d{4}(-\d{2}(-\d{2})?)?$ description: >- A date at the precision the source knows it. The value's length is its precision: `YYYY` when only the year is known, `YYYY-MM` for the month, `YYYY-MM-DD` for the day. Never padded: an unknown month or day shortens the value rather than defaulting to `01`. Deliberately not `format: date`, which requires a full day. example: 2024-03 OrganizationSummary: oneOf: - $ref: '#/components/schemas/CompanySummary' - $ref: '#/components/schemas/UniversitySummary' - $ref: '#/components/schemas/GovNgoSummary' - $ref: '#/components/schemas/InvestorSummary' discriminator: propertyName: subtype mapping: company: '#/components/schemas/CompanySummary' university: '#/components/schemas/UniversitySummary' gov_ngo: '#/components/schemas/GovNgoSummary' investor: '#/components/schemas/InvestorSummary' title: Organization description: >- An entity as it appears on another row: its type's row without the full-only blocks. type: object CompanySummary: type: object properties: uuid: type: string description: Stable UUID of the entity; the sole public identifier. example: 345d1ab6-33df-4759-9e17-0d0c0ec9ab1c type: type: string enum: - organization description: >- 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: type: - string - 'null' description: Registrable domain, e.g. "stripe.com". example: stripe.com name: type: string description: Display name. example: Stripe tagline: type: - string - 'null' description: One-line description. about: type: - string - 'null' description: Long-form description. image: type: - string - 'null' description: Absolute logo URL. dealroom_url: type: - string - 'null' description: Canonical profile URL on app.dealroom.co. links: type: object properties: website: type: - string - 'null' description: Website URL. linkedin: type: - string - 'null' description: LinkedIn profile URL. twitter: type: - string - 'null' description: Twitter / X profile URL. instagram: type: - string - 'null' description: Instagram URL or handle. angellist: type: - string - 'null' description: AngelList URL or handle. crunchbase: type: - string - 'null' description: Crunchbase profile URL. required: - website - linkedin - twitter - instagram - angellist - crunchbase description: The entity's own presence on the web; each null when unknown. locations: type: array items: type: object properties: role: $ref: '#/components/schemas/LocationRole' city: type: - object - 'null' properties: id: type: number description: Location id, as accepted by the location filters. name: type: string description: Location name. required: - id - name description: City; null when not known. state: type: - object - 'null' properties: id: type: number description: Location id, as accepted by the location filters. name: type: string description: Location name. required: - id - name description: State or region; null when none. country: type: - object - 'null' properties: id: type: number description: Location id, as accepted by the location filters. name: type: string description: Location name. required: - id - name description: Country. continent: type: - object - 'null' properties: id: type: number description: Location id, as accepted by the location filters. name: type: string description: Location name. required: - id - name description: Continent. lat: type: - number - 'null' description: Entity coordinates when known, otherwise the city centroid. lon: type: - number - 'null' description: Entity coordinates when known, otherwise the city centroid. required: - role - city - state - country - continent - lat - lon description: 'Every location: hq, founding, then offices; empty when none.' roles: type: array items: $ref: '#/components/schemas/EntityRole' description: >- Roles the organization plays: `investor`, `limited_partner`, `fund_manager`. taxonomy: type: array items: type: object properties: id: type: number description: Numeric identifier of the tag. name: type: string description: Display name of the tag. type: $ref: '#/components/schemas/TagType' required: - id - name - type description: >- Taxonomy terms (industries, sectors, technologies, …); empty when none. launch_date: anyOf: - $ref: '#/components/schemas/PartialDate' - type: 'null' description: When the organization was founded, at source precision. closing_date: anyOf: - $ref: '#/components/schemas/PartialDate' - type: 'null' description: When the organization closed; null while active. employees_count: type: - number - 'null' description: Number of employees. added_at: type: - string - 'null' format: date-time description: When the organization was added to Dealroom (RFC 3339). updated_at: type: - string - 'null' format: date-time description: When the record was last modified (RFC 3339). subtype: type: string enum: - company description: >- Organization subtype — one of `company`, `university`, `gov_ngo`, `investor`. Mutually exclusive. Always null for persons. classifications: type: array items: $ref: '#/components/schemas/Classification' description: Dealroom labels; empty when none. employee_count_1y_growth: type: - number - 'null' description: Year-over-year employee growth, %. status: anyOf: - $ref: '#/components/schemas/CompanyStatus' - type: 'null' description: Operational status. signal_rating: type: - number - 'null' description: Dealroom Signal rating (0-100). unicorn_type: type: - string - 'null' description: Unicorn tier, e.g. "unicorn", "decacorn". became_unicorn_date: anyOf: - $ref: '#/components/schemas/PartialDate' - type: 'null' description: When the company reached a $1B valuation. became_thoroughbred_date: anyOf: - $ref: '#/components/schemas/PartialDate' - type: 'null' description: When the company was verified as a Thoroughbred. exit_date: anyOf: - $ref: '#/components/schemas/PartialDate' - type: 'null' description: When the company exited (IPO or acquisition). investor: type: - object - 'null' properties: types: type: array items: type: object properties: id: type: number description: Tag id. name: type: string description: Display name. code: type: string description: Machine-readable code. required: - id - name - code description: Investor types; empty when none. stages: type: array items: type: object properties: id: type: number description: Tag id. name: type: string description: Display name. code: type: string description: Machine-readable code. required: - id - name - code description: Stages invested in; empty when none. deal_size: type: - object - 'null' properties: min: type: - number - 'null' description: Smallest ticket, active currency. max: type: - number - 'null' description: Largest ticket, active currency. required: - min - max description: Ticket size range; null when unknown. investments: type: object properties: count: type: - number - 'null' description: Investments made. total_invested: type: - number - 'null' description: >- Total size of the funding rounds the investor participated in (the full round amounts, not the investor's own ticket), active currency. preferred_round: type: - string - 'null' description: Most frequent round stage, e.g. `series_a`. last_round_date: anyOf: - $ref: '#/components/schemas/PartialDate' - type: 'null' description: >- Date of the most recent investment round, at source precision. required: - count - total_invested - preferred_round - last_round_date description: Investment activity. required: - types - stages - deal_size - investments description: The organization's investing profile; null unless it invests. funding: type: - object - 'null' properties: total: type: - number - 'null' description: Total raised, active currency. total_vc: type: - number - 'null' description: VC-only share of `total`. rounds_count: type: - number - 'null' description: Funding rounds recorded. required: - total - total_vc - rounds_count description: Funding raised; null when no round is recorded. valuation: type: - object - 'null' properties: value: type: - number - 'null' description: Latest valuation, active currency. year: type: - number - 'null' description: Year the valuation was recorded. month: type: - number - 'null' description: Month (1-12); null when unknown. required: - value - year - month description: Most recent valuation, with the period it applies to. jobs: type: object properties: is_hiring: type: - boolean - 'null' description: Currently recruiting. open_count: type: number description: Active job openings; 0 when none. required: - is_hiring - open_count description: Hiring status and open roles. required: - uuid - type - domain - name - tagline - about - image - dealroom_url - links - locations - roles - taxonomy - launch_date - closing_date - employees_count - added_at - updated_at - subtype - classifications - employee_count_1y_growth - status - signal_rating - unicorn_type - became_unicorn_date - became_thoroughbred_date - exit_date - investor - funding - valuation - jobs title: Company description: >- An entity as it appears on another row: its type's row without the full-only blocks. UniversitySummary: type: object properties: uuid: type: string description: Stable UUID of the entity; the sole public identifier. example: 345d1ab6-33df-4759-9e17-0d0c0ec9ab1c type: type: string enum: - organization description: >- 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: type: - string - 'null' description: Registrable domain, e.g. "stripe.com". example: stripe.com name: type: string description: Display name. example: Stripe tagline: type: - string - 'null' description: One-line description. about: type: - string - 'null' description: Long-form description. image: type: - string - 'null' description: Absolute logo URL. dealroom_url: type: - string - 'null' description: Canonical profile URL on app.dealroom.co. links: type: object properties: website: type: - string - 'null' description: Website URL. linkedin: type: - string - 'null' description: LinkedIn profile URL. twitter: type: - string - 'null' description: Twitter / X profile URL. instagram: type: - string - 'null' description: Instagram URL or handle. angellist: type: - string - 'null' description: AngelList URL or handle. crunchbase: type: - string - 'null' description: Crunchbase profile URL. required: - website - linkedin - twitter - instagram - angellist - crunchbase description: The entity's own presence on the web; each null when unknown. locations: type: array items: type: object properties: role: $ref: '#/components/schemas/LocationRole' city: type: - object - 'null' properties: id: type: number description: Location id, as accepted by the location filters. name: type: string description: Location name. required: - id - name description: City; null when not known. state: type: - object - 'null' properties: id: type: number description: Location id, as accepted by the location filters. name: type: string description: Location name. required: - id - name description: State or region; null when none. country: type: - object - 'null' properties: id: type: number description: Location id, as accepted by the location filters. name: type: string description: Location name. required: - id - name description: Country. continent: type: - object - 'null' properties: id: type: number description: Location id, as accepted by the location filters. name: type: string description: Location name. required: - id - name description: Continent. lat: type: - number - 'null' description: Entity coordinates when known, otherwise the city centroid. lon: type: - number - 'null' description: Entity coordinates when known, otherwise the city centroid. required: - role - city - state - country - continent - lat - lon description: 'Every location: hq, founding, then offices; empty when none.' roles: type: array items: $ref: '#/components/schemas/EntityRole' description: >- Roles the organization plays: `investor`, `limited_partner`, `fund_manager`. taxonomy: type: array items: type: object properties: id: type: number description: Numeric identifier of the tag. name: type: string description: Display name of the tag. type: $ref: '#/components/schemas/TagType' required: - id - name - type description: >- Taxonomy terms (industries, sectors, technologies, …); empty when none. launch_date: anyOf: - $ref: '#/components/schemas/PartialDate' - type: 'null' description: When the organization was founded, at source precision. closing_date: anyOf: - $ref: '#/components/schemas/PartialDate' - type: 'null' description: When the organization closed; null while active. employees_count: type: - number - 'null' description: Number of employees. added_at: type: - string - 'null' format: date-time description: When the organization was added to Dealroom (RFC 3339). updated_at: type: - string - 'null' format: date-time description: When the record was last modified (RFC 3339). subtype: type: string enum: - university description: >- Organization subtype — one of `company`, `university`, `gov_ngo`, `investor`. Mutually exclusive. Always null for persons. spinouts_count: type: - number - 'null' description: Spinout companies originating from the university. investor: type: - object - 'null' properties: types: type: array items: type: object properties: id: type: number description: Tag id. name: type: string description: Display name. code: type: string description: Machine-readable code. required: - id - name - code description: Investor types; empty when none. stages: type: array items: type: object properties: id: type: number description: Tag id. name: type: string description: Display name. code: type: string description: Machine-readable code. required: - id - name - code description: Stages invested in; empty when none. deal_size: type: - object - 'null' properties: min: type: - number - 'null' description: Smallest ticket, active currency. max: type: - number - 'null' description: Largest ticket, active currency. required: - min - max description: Ticket size range; null when unknown. investments: type: object properties: count: type: - number - 'null' description: Investments made. total_invested: type: - number - 'null' description: >- Total size of the funding rounds the investor participated in (the full round amounts, not the investor's own ticket), active currency. preferred_round: type: - string - 'null' description: Most frequent round stage, e.g. `series_a`. last_round_date: anyOf: - $ref: '#/components/schemas/PartialDate' - type: 'null' description: >- Date of the most recent investment round, at source precision. required: - count - total_invested - preferred_round - last_round_date description: Investment activity. required: - types - stages - deal_size - investments description: The organization's investing profile; null unless it invests. required: - uuid - type - domain - name - tagline - about - image - dealroom_url - links - locations - roles - taxonomy - launch_date - closing_date - employees_count - added_at - updated_at - subtype - spinouts_count - investor title: University description: >- An entity as it appears on another row: its type's row without the full-only blocks. GovNgoSummary: type: object properties: uuid: type: string description: Stable UUID of the entity; the sole public identifier. example: 345d1ab6-33df-4759-9e17-0d0c0ec9ab1c type: type: string enum: - organization description: >- 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: type: - string - 'null' description: Registrable domain, e.g. "stripe.com". example: stripe.com name: type: string description: Display name. example: Stripe tagline: type: - string - 'null' description: One-line description. about: type: - string - 'null' description: Long-form description. image: type: - string - 'null' description: Absolute logo URL. dealroom_url: type: - string - 'null' description: Canonical profile URL on app.dealroom.co. links: type: object properties: website: type: - string - 'null' description: Website URL. linkedin: type: - string - 'null' description: LinkedIn profile URL. twitter: type: - string - 'null' description: Twitter / X profile URL. instagram: type: - string - 'null' description: Instagram URL or handle. angellist: type: - string - 'null' description: AngelList URL or handle. crunchbase: type: - string - 'null' description: Crunchbase profile URL. required: - website - linkedin - twitter - instagram - angellist - crunchbase description: The entity's own presence on the web; each null when unknown. locations: type: array items: type: object properties: role: $ref: '#/components/schemas/LocationRole' city: type: - object - 'null' properties: id: type: number description: Location id, as accepted by the location filters. name: type: string description: Location name. required: - id - name description: City; null when not known. state: type: - object - 'null' properties: id: type: number description: Location id, as accepted by the location filters. name: type: string description: Location name. required: - id - name description: State or region; null when none. country: type: - object - 'null' properties: id: type: number description: Location id, as accepted by the location filters. name: type: string description: Location name. required: - id - name description: Country. continent: type: - object - 'null' properties: id: type: number description: Location id, as accepted by the location filters. name: type: string description: Location name. required: - id - name description: Continent. lat: type: - number - 'null' description: Entity coordinates when known, otherwise the city centroid. lon: type: - number - 'null' description: Entity coordinates when known, otherwise the city centroid. required: - role - city - state - country - continent - lat - lon description: 'Every location: hq, founding, then offices; empty when none.' roles: type: array items: $ref: '#/components/schemas/EntityRole' description: >- Roles the organization plays: `investor`, `limited_partner`, `fund_manager`. taxonomy: type: array items: type: object properties: id: type: number description: Numeric identifier of the tag. name: type: string description: Display name of the tag. type: $ref: '#/components/schemas/TagType' required: - id - name - type description: >- Taxonomy terms (industries, sectors, technologies, …); empty when none. launch_date: anyOf: - $ref: '#/components/schemas/PartialDate' - type: 'null' description: When the organization was founded, at source precision. closing_date: anyOf: - $ref: '#/components/schemas/PartialDate' - type: 'null' description: When the organization closed; null while active. employees_count: type: - number - 'null' description: Number of employees. added_at: type: - string - 'null' format: date-time description: When the organization was added to Dealroom (RFC 3339). updated_at: type: - string - 'null' format: date-time description: When the record was last modified (RFC 3339). subtype: type: string enum: - gov_ngo description: >- Organization subtype — one of `company`, `university`, `gov_ngo`, `investor`. Mutually exclusive. Always null for persons. classifications: type: array items: $ref: '#/components/schemas/Classification' description: Dealroom labels; empty when none. signal_rating: type: - number - 'null' description: Dealroom Signal rating (0-100). investor: type: - object - 'null' properties: types: type: array items: type: object properties: id: type: number description: Tag id. name: type: string description: Display name. code: type: string description: Machine-readable code. required: - id - name - code description: Investor types; empty when none. stages: type: array items: type: object properties: id: type: number description: Tag id. name: type: string description: Display name. code: type: string description: Machine-readable code. required: - id - name - code description: Stages invested in; empty when none. deal_size: type: - object - 'null' properties: min: type: - number - 'null' description: Smallest ticket, active currency. max: type: - number - 'null' description: Largest ticket, active currency. required: - min - max description: Ticket size range; null when unknown. investments: type: object properties: count: type: - number - 'null' description: Investments made. total_invested: type: - number - 'null' description: >- Total size of the funding rounds the investor participated in (the full round amounts, not the investor's own ticket), active currency. preferred_round: type: - string - 'null' description: Most frequent round stage, e.g. `series_a`. last_round_date: anyOf: - $ref: '#/components/schemas/PartialDate' - type: 'null' description: >- Date of the most recent investment round, at source precision. required: - count - total_invested - preferred_round - last_round_date description: Investment activity. required: - types - stages - deal_size - investments description: The organization's investing profile; null unless it invests. funding: type: - object - 'null' properties: total: type: - number - 'null' description: Total raised, active currency. total_vc: type: - number - 'null' description: VC-only share of `total`. rounds_count: type: - number - 'null' description: Funding rounds recorded. required: - total - total_vc - rounds_count description: Funding raised; null when no round is recorded. jobs: type: object properties: is_hiring: type: - boolean - 'null' description: Currently recruiting. open_count: type: number description: Active job openings; 0 when none. required: - is_hiring - open_count description: Hiring status and open roles. required: - uuid - type - domain - name - tagline - about - image - dealroom_url - links - locations - roles - taxonomy - launch_date - closing_date - employees_count - added_at - updated_at - subtype - classifications - signal_rating - investor - funding - jobs title: Government & NGO description: >- An entity as it appears on another row: its type's row without the full-only blocks. InvestorSummary: type: object properties: uuid: type: string description: Stable UUID of the entity; the sole public identifier. example: 345d1ab6-33df-4759-9e17-0d0c0ec9ab1c type: type: string enum: - organization description: >- 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: type: - string - 'null' description: Registrable domain, e.g. "stripe.com". example: stripe.com name: type: string description: Display name. example: Stripe tagline: type: - string - 'null' description: One-line description. about: type: - string - 'null' description: Long-form description. image: type: - string - 'null' description: Absolute logo URL. dealroom_url: type: - string - 'null' description: Canonical profile URL on app.dealroom.co. links: type: object properties: website: type: - string - 'null' description: Website URL. linkedin: type: - string - 'null' description: LinkedIn profile URL. twitter: type: - string - 'null' description: Twitter / X profile URL. instagram: type: - string - 'null' description: Instagram URL or handle. angellist: type: - string - 'null' description: AngelList URL or handle. crunchbase: type: - string - 'null' description: Crunchbase profile URL. required: - website - linkedin - twitter - instagram - angellist - crunchbase description: The entity's own presence on the web; each null when unknown. locations: type: array items: type: object properties: role: $ref: '#/components/schemas/LocationRole' city: type: - object - 'null' properties: id: type: number description: Location id, as accepted by the location filters. name: type: string description: Location name. required: - id - name description: City; null when not known. state: type: - object - 'null' properties: id: type: number description: Location id, as accepted by the location filters. name: type: string description: Location name. required: - id - name description: State or region; null when none. country: type: - object - 'null' properties: id: type: number description: Location id, as accepted by the location filters. name: type: string description: Location name. required: - id - name description: Country. continent: type: - object - 'null' properties: id: type: number description: Location id, as accepted by the location filters. name: type: string description: Location name. required: - id - name description: Continent. lat: type: - number - 'null' description: Entity coordinates when known, otherwise the city centroid. lon: type: - number - 'null' description: Entity coordinates when known, otherwise the city centroid. required: - role - city - state - country - continent - lat - lon description: 'Every location: hq, founding, then offices; empty when none.' roles: type: array items: $ref: '#/components/schemas/EntityRole' description: >- Roles the organization plays: `investor`, `limited_partner`, `fund_manager`. taxonomy: type: array items: type: object properties: id: type: number description: Numeric identifier of the tag. name: type: string description: Display name of the tag. type: $ref: '#/components/schemas/TagType' required: - id - name - type description: >- Taxonomy terms (industries, sectors, technologies, …); empty when none. launch_date: anyOf: - $ref: '#/components/schemas/PartialDate' - type: 'null' description: When the organization was founded, at source precision. closing_date: anyOf: - $ref: '#/components/schemas/PartialDate' - type: 'null' description: When the organization closed; null while active. employees_count: type: - number - 'null' description: Number of employees. added_at: type: - string - 'null' format: date-time description: When the organization was added to Dealroom (RFC 3339). updated_at: type: - string - 'null' format: date-time description: When the record was last modified (RFC 3339). subtype: type: string enum: - investor description: >- Organization subtype — one of `company`, `university`, `gov_ngo`, `investor`. Mutually exclusive. Always null for persons. signal_rating: type: - number - 'null' description: Dealroom Signal rating (0-100). types: type: array items: type: object properties: id: type: number description: Tag id. name: type: string description: Display name. code: type: string description: Machine-readable code. required: - id - name - code description: Investor types; empty when none. stages: type: array items: type: object properties: id: type: number description: Tag id. name: type: string description: Display name. code: type: string description: Machine-readable code. required: - id - name - code description: Stages invested in; empty when none. deal_size: type: - object - 'null' properties: min: type: - number - 'null' description: Smallest ticket, active currency. max: type: - number - 'null' description: Largest ticket, active currency. required: - min - max description: Ticket size range; null when unknown. investments: type: object properties: count: type: - number - 'null' description: Investments made. total_invested: type: - number - 'null' description: >- Total size of the funding rounds the investor participated in (the full round amounts, not the investor's own ticket), active currency. preferred_round: type: - string - 'null' description: Most frequent round stage, e.g. `series_a`. last_round_date: anyOf: - $ref: '#/components/schemas/PartialDate' - type: 'null' description: Date of the most recent investment round, at source precision. required: - count - total_invested - preferred_round - last_round_date description: Investment activity. investor: type: 'null' description: 'Always null: an investor''s profile is flat at the root.' required: - uuid - type - domain - name - tagline - about - image - dealroom_url - links - locations - roles - taxonomy - launch_date - closing_date - employees_count - added_at - updated_at - subtype - signal_rating - types - stages - deal_size - investments - investor title: Investor firm description: >- An entity as it appears on another row: its type's row without the full-only blocks. LocationRole: type: string enum: - hq - founding - office description: >- `hq`, `founding` or `office`. An entity has at most one `hq` and one `founding` location, and any number of offices. EntityRole: type: string enum: - founder - executive - partner - investor - limited_partner - fund_manager description: >- A role the entity plays: person roles (founder, executive, partner, investor) and organization roles (investor, limited_partner, fund_manager). TagType: type: string enum: - sector - technology - industry - sub_industry - business_model - income_stream - client_focus - sdg - ownership - techstack_category - deal_structure - growth_stage - investor_type - background description: Category of a tag (e.g. industry, sector, technology). Classification: type: string enum: - startup - colt - titan - rising_star - spinout - thoroughbred - unicorn - vc_backed - funded - exited - pe_owned - serial_founder - super_founder - promising_founder - strong_founder description: >- A Dealroom label. New values are added without a version change, so a client must tolerate a value it does not recognise. CompanyStatus: type: string enum: - operational - acquired - closed - low_activity description: Operational status of a company. headers: X-Credits-Used: description: >- Credits this request consumed, under the current credit schedule. Present on every response to an API-key request under `/data`, `/analytics` and `/reference`; `0` on an error response or a free endpoint. Absent when the request was not authenticated with an API key (so never on a `401`), or on unmetered endpoints. During open beta credits are drawn from the team's balance but not billed. schema: type: integer minimum: 0 example: 25 Deprecation: description: >- Present when the request pinned a superseded version: the date that version was deprecated (`YYYY-MM-DD`). schema: type: string format: date Sunset: description: >- Present when the request pinned a superseded version: the date the version stops working and requests begin returning `400` (`YYYY-MM-DD`). schema: type: string format: date securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Auth0 JWT access token. Paste a token obtained from your preferred OAuth2 flow. For machine-to-machine use, the OAuth2 client_credentials scheme below can mint a token directly from your `client_id` / `client_secret` inside the Swagger UI Authorize dialog. oauth2: type: oauth2 description: >- OAuth2 client-credentials flow against the Dealroom Auth0 tenant. Use the `client_id` / `client_secret` from a Programmatic API key. Tokens are valid for 24h — Swagger UI will reuse the same token across operations. Revoking or deactivating a key rejects it on the next request (within a ≤5-minute server-side cache window), not at token expiry. flows: clientCredentials: tokenUrl: https://accounts.dealroom.co/oauth/token scopes: read:entities: Grant the read:entities permission read:transactions: Grant the read:transactions permission read:valuations: Grant the read:valuations permission read:investors: Grant the read:investors permission read:founders: Grant the read:founders permission read:dimensions: Grant the read:dimensions permission read:timeseries: Grant the read:timeseries permission read:aggregate: Grant the read:aggregate permission read:news: Grant the read:news permission read:jobs: Grant the read:jobs permission read:people: Grant the read:people permission read:search: Grant the read:search permission ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.