# Dealroom API

## Docs

- [Change password](https://developers.dealroom.co/api-reference/account/change-password.md): Sets a new password for the authenticated user. Only applicable to password-based accounts (`sub` starts with `auth0|`).
- [Confirm email change](https://developers.dealroom.co/api-reference/account/confirm-email-change.md): Confirms an email change using the token sent to the new address via `/me/change-email`.
- [Delete account](https://developers.dealroom.co/api-reference/account/delete-account.md): Permanently deletes the authenticated user's account. Deletes the Auth0 user first, then orphans all API keys owned by the user (sets `created_by` to NULL) and removes all team memberships. Auth0 is deleted first so a transient failure there leaves the account fully intact. M2M tokens are not allowe…
- [Get current user](https://developers.dealroom.co/api-reference/account/get-current-user.md): Returns the authenticated user's decoded token claims — sub, roles, permissions, tier, and ecosystem source. Useful for verifying that your JWT contains the expected roles, permissions, and custom claims.
- [Internal: send verification email](https://developers.dealroom.co/api-reference/account/internal:-send-verification-email.md): Triggered by the Auth0 post-registration Action to send the account's verification email. Authenticated by the `x-registration-secret` shared-secret header, not a user JWT.
- [Request email change](https://developers.dealroom.co/api-reference/account/request-email-change.md): Sends a confirmation link to the new email address. The change takes effect only after the user confirms via `/me/change-email/confirm`.
- [Resend verification email](https://developers.dealroom.co/api-reference/account/resend-verification-email.md): Only applicable for password-based accounts (sub starts with `auth0|`). Triggers Auth0 to send a new verification email to the user's registered address.
- [Update current user](https://developers.dealroom.co/api-reference/account/update-current-user.md): Updates the authenticated user's display name.
- [Aggregate by source](https://developers.dealroom.co/api-reference/aggregate/aggregate-by-source.md): Query a specific source (founders, investors, companies, funding-rounds, valuations) with structured filter syntax.
- [Multi-metric aggregate](https://developers.dealroom.co/api-reference/aggregate/multi-metric-aggregate.md): Return multiple labeled metrics from a single SQL query, each with optional per-metric filters using aggregate FILTER (WHERE ...) clauses. Supports all metric types (COUNT, SUM, AVG, MEDIAN, MAX) and optional dimensional grouping (group_by).
- [Create API key](https://developers.dealroom.co/api-reference/api-keys/create-api-key.md): Provisions an Auth0 application and returns the client credentials.
- [Get API key](https://developers.dealroom.co/api-reference/api-keys/get-api-key.md): Returns metadata for an API key — name, type (`m2m` or `application`), the granted permission set, `client_id`, last-used timestamp, and allowed origins / callbacks for application keys. Never returns the `client_secret` (only available at creation time). Requires the `read:api-keys` scope.
- [List API keys](https://developers.dealroom.co/api-reference/api-keys/list-api-keys.md): Returns all active API keys for the authenticated user. Users with the `admin:api-keys` permission see all keys across the organization. Secrets are never returned.
- [Revoke API key](https://developers.dealroom.co/api-reference/api-keys/revoke-api-key.md): Deactivates the API key and deletes the Auth0 M2M application.
- [Get financials](https://developers.dealroom.co/api-reference/companies/get-financials.md): One row per recorded year of revenue, EBITDA, valuation, and employee count. Monetary values convert to the requested `?currency=` (default USD).
- [Get headcount breakdown](https://developers.dealroom.co/api-reference/companies/get-headcount-breakdown.md): Full monthly employee-distribution series for a company across both breakdown dimensions — `country` (employee distribution by country) and `department` — ordered chronologically (oldest first). Each row is one item's percentage share of headcount for a month. Narrow to a single dimension with `?typ…
- [Get single company](https://developers.dealroom.co/api-reference/companies/get-single-company.md): Returns the full company record by UUID (numeric IDs are not accepted), including the `company` sub-object (unicorn/VC-backed flags, status, traffic) alongside the shared entity base fields. Monetary fields convert to the requested `?currency=` (default USD).
- [Get web traffic](https://developers.dealroom.co/api-reference/companies/get-web-traffic.md): Full monthly web-visit estimate series for a company, ordered chronologically (oldest first) — the data behind the web-traffic trend chart on the company profile. Visit counts are SimilarWeb-derived estimates. Returns an empty list for companies with no recorded traffic.
- [List companies](https://developers.dealroom.co/api-reference/companies/list-companies.md): Returns a paginated list of companies (entities with `organization_subtype = company`) — the subset of the entity index that excludes investors, universities, and gov/NGOs. Supports the full entity filter syntax, sorting, and pagination. Monetary fields convert to the requested `?currency=` (default…
- [List company team members](https://developers.dealroom.co/api-reference/companies/list-company-team-members.md): People associated with the company through the people_entities relationship (founders, executives, partners, and other team members). Supports the same person filter DSL as `/api/data/people`, plus `role` and `is_past` relationship filters.
- [List funding rounds](https://developers.dealroom.co/api-reference/companies/list-funding-rounds.md): Funding-related transactions (rounds, equity events, debt, grants) for a company, newest first. Same data as `/api/data/entities/{id}/transactions`. Monetary fields (`amount`, `valuation`) convert to the requested `?currency=` (default USD).
- [List investors](https://developers.dealroom.co/api-reference/companies/list-investors.md): Investors that participated in the company's funding rounds, de-duplicated to one row per investor with their aggregate involvement.
- [List similar companies](https://developers.dealroom.co/api-reference/companies/list-similar-companies.md): Companies ranked by similarity to this company, scored by weighted overlap of shared categorical tags (sector, sub-industry, industry, client focus, technology, income stream) — the legacy app.dealroom.co similar-companies model. Force-sorted by score; supports the full company filter DSL to narrow…
- [List valuations](https://developers.dealroom.co/api-reference/companies/list-valuations.md): Valuation history (one row per recorded year/month) for a company. The `value` field converts to the requested `?currency=` (default USD).
- [Analytics Namespace Discovery](https://developers.dealroom.co/api-reference/discovery/analytics-namespace-discovery.md): Lists the resources available under the `analytics` namespace. Computed metrics & tools: aggregates, funding analytics, timeseries, and investor matching.
- [API Root Discovery](https://developers.dealroom.co/api-reference/discovery/api-root-discovery.md): Programmatic entry point for the Dealroom API. Returns available functional namespaces and links to documentation. Follow a namespace `url` to discover the resources it contains.
- [Data Namespace Discovery](https://developers.dealroom.co/api-reference/discovery/data-namespace-discovery.md): Lists the resources available under the `data` namespace. Raw domain data: companies, investors, founders, people, funding rounds, valuations, news, jobs, and cross-resource search.
- [Platform Namespace Discovery](https://developers.dealroom.co/api-reference/discovery/platform-namespace-discovery.md): Lists the resources available under the `platform` namespace. Account, IAM & site configuration: account, API keys, teams, usage, and ecosystem site config.
- [Reference Namespace Discovery](https://developers.dealroom.co/api-reference/discovery/reference-namespace-discovery.md): Lists the resources available under the `reference` namespace. Taxonomy & discovery: filters and curated landscapes.
- [System Namespace Discovery](https://developers.dealroom.co/api-reference/discovery/system-namespace-discovery.md): Lists the resources available under the `system` namespace. Operational endpoints: observability metrics and service health.
- [Create ecosystem](https://developers.dealroom.co/api-reference/ecosystems/create-ecosystem.md): > ⚠ **TABLE NOT LOADED FROM BIGQUERY** — Persists to the user-owned `ecosystems` table. No BigQuery source feeds this table.
- [Delete ecosystem](https://developers.dealroom.co/api-reference/ecosystems/delete-ecosystem.md): > ⚠ **TABLE NOT LOADED FROM BIGQUERY** — Soft-deletes a row in the user-owned `ecosystems` table.
- [Get current ecosystem](https://developers.dealroom.co/api-reference/ecosystems/get-current-ecosystem.md): > ⚠ **TABLE NOT LOADED FROM BIGQUERY** — Resolves the ecosystem from the request origin against `ecosystem_domains`, a user-owned table not populated by the BigQuery loader. Returns `{ data: null }` until domains are registered via PUT.
- [Get ecosystem](https://developers.dealroom.co/api-reference/ecosystems/get-ecosystem.md): > ⚠ **TABLE NOT LOADED FROM BIGQUERY** — Backed by the same user-owned `ecosystems` table — IDs only exist after a POST.
- [List ecosystem domains](https://developers.dealroom.co/api-reference/ecosystems/list-ecosystem-domains.md): > ⚠ **TABLE NOT LOADED FROM BIGQUERY** — The `ecosystem_domains` table is user-owned and not populated by the BigQuery loader. Fresh deployments return an empty list until domains are registered.
- [List ecosystem limits](https://developers.dealroom.co/api-reference/ecosystems/list-ecosystem-limits.md): > ⚠ **TABLE NOT LOADED FROM BIGQUERY** — The `ecosystem_limits` table is user-owned and not populated by the BigQuery loader. Fresh deployments return an empty list until limits are configured.
- [List ecosystems](https://developers.dealroom.co/api-reference/ecosystems/list-ecosystems.md): > ⚠ **TABLE NOT LOADED FROM BIGQUERY** — The `ecosystems` table is user-owned and not populated by the BigQuery loader. Fresh deployments return an empty list until ecosystems are created via POST.
- [Update ecosystem](https://developers.dealroom.co/api-reference/ecosystems/update-ecosystem.md): > ⚠ **TABLE NOT LOADED FROM BIGQUERY** — Updates the user-owned `ecosystems` table. Changes do not sync to BigQuery and may be lost on full reseed.
- [Update ecosystem domains](https://developers.dealroom.co/api-reference/ecosystems/update-ecosystem-domains.md): > ⚠ **TABLE NOT LOADED FROM BIGQUERY** — Persists to the user-owned `ecosystem_domains` table. Changes are not backed by BigQuery and may be lost on full reseed.
- [Update ecosystem limits](https://developers.dealroom.co/api-reference/ecosystems/update-ecosystem-limits.md): > ⚠ **TABLE NOT LOADED FROM BIGQUERY** — Persists to the user-owned `ecosystem_limits` table. Changes are not backed by BigQuery and may be lost on full reseed.
- [Submit enhancement request](https://developers.dealroom.co/api-reference/enhancement-requests/submit-enhancement-request.md): Sends the requesting user's free-text profile-data correction request to the Dealroom Data Support inbox via the emails-service. Requires an authenticated human user; M2M tokens are rejected.
- [Get single entity](https://developers.dealroom.co/api-reference/entities/get-single-entity.md): Returns the full entity record by UUID (numeric IDs are not accepted). The response shape varies by entity type — companies, investors, people, and universities each expose an optional sub-object (`company`, `investor`, `person`, `university`) alongside the shared base fields. Read the `type` / `org…
- [List entities](https://developers.dealroom.co/api-reference/entities/list-entities.md): Returns a paginated list of entities — the unified index across companies, investors, people, and universities. Filter by 90+ keys (funding, location, sector, status, etc.), sort by any indexed field, and page through results. Monetary fields are converted to the requested `?currency=` (default USD)…
- [List entity geo points](https://developers.dealroom.co/api-reference/entities/list-entity-geo-points.md): Lightweight endpoint designed to power map/geo visualizations, returning only id, name, lat, lon, country, and city. Supports the same filters as the entity list but with higher limits (up to 5000) and minimal payload.
- [List LP fund positions](https://developers.dealroom.co/api-reference/entities/list-lp-fund-positions.md): Lists the investor firms whose known limited partners include this entity — e.g. the accelerator programmes and VC firms a university has committed capital to. Each row is an investor-firm entity (not an `investment_fund` vehicle) and carries its investor type names. The source data holds only the L…
- [List filter values](https://developers.dealroom.co/api-reference/filters/list-filter-values.md): Returns values for a filter with entity counts. Supports fuzzy search, pagination, and optional metadata enrichment. Only filters with type id_lookup or enum have values.
- [List filters](https://developers.dealroom.co/api-reference/filters/list-filters.md): Returns available filters for the given scope with category grouping, operators, and optional user-facing descriptions and examples. Valid scopes: companies, investors, transactions, people, universities, news, jobs.
- [Search filters and values](https://developers.dealroom.co/api-reference/filters/search-filters-and-values.md): Returns the picker-ready search result set for one scope: year-intent matches, value matches across every searchable dimension, and filter-name/description matches. Single round-trip replacement for the client-side fan-out across `/api/reference/filters/:key/values`.
- [Get single founder](https://developers.dealroom.co/api-reference/founders/get-single-founder.md): Returns the full founder profile by UUID (numeric IDs are not accepted). Includes biographic details, founder badges (super founder, serial founder, etc.), professional history, education, and links to founded companies.
- [List founded companies](https://developers.dealroom.co/api-reference/founders/list-founded-companies.md): The companies (and other organizations) this person founded — a preset over the person career relationship filtered to the founder role. Same row shape as `/api/data/people/{id}/career`, newest tenure first.
- [List founders](https://developers.dealroom.co/api-reference/founders/list-founders.md): Returns a paginated list of founders (entities with is_founder=true) with company associations, education history, and professional backgrounds. Supports the same filter syntax as other endpoints.
- [Funding funnel](https://developers.dealroom.co/api-reference/funding-analytics/funding-funnel.md): Cross-tabulates companies by total capital raised (9 buckets) against a chosen dimension.
- [Funding heatmap](https://developers.dealroom.co/api-reference/funding-analytics/funding-heatmap.md): Returns a 2D matrix of funding data grouped by two configurable dimensions.
- [Round transitions](https://developers.dealroom.co/api-reference/funding-analytics/round-transitions.md): Analyzes how companies move between funding stages over time.
- [Get single fund](https://developers.dealroom.co/api-reference/funds/get-single-fund.md): Returns one fund by its stable Dealroom fund id, including the manager (GP) that raised it. `amount` is the fund size in the requested `?currency=` (default USD); `amount_source` carries the original native amount.
- [List funds](https://developers.dealroom.co/api-reference/funds/list-funds.md): Returns a paginated list of funds — the capital vehicles investor firms raise — newest first. Filter by manager (`investor_id`), `fund_type`, `is_closed`, `min_amount`, or vintage `year`. Each fund links to its manager (GP). `amount` is the fund size in the requested `?currency=` (default USD); `amo…
- [Get single government/NGO entity](https://developers.dealroom.co/api-reference/government-&-ngo/get-single-governmentngo-entity.md): Returns the full government/NGO record by UUID (numeric IDs are not accepted), alongside the shared entity base fields.
- [List government & NGO entities](https://developers.dealroom.co/api-reference/government-&-ngo/list-government-&-ngo-entities.md): Returns a paginated list of government bodies and NGOs (entities with `organization_subtype = gov_ngo`). Supports the full entity filter syntax, sorting, and pagination.
- [List government & NGO team members](https://developers.dealroom.co/api-reference/government-&-ngo/list-government-&-ngo-team-members.md): People associated with the government body or NGO through the people_entities relationship. Supports the same person filter DSL as `/api/data/people`, plus `role` and `is_past` relationship filters.
- [Check API health](https://developers.dealroom.co/api-reference/health/check-api-health.md): Public liveness probe. Returns `200` when the API can reach the database, `503` otherwise. No authentication required — safe to use from uptime monitors and load-balancer health checks.
- [Check system health](https://developers.dealroom.co/api-reference/health/check-system-health.md): Authenticated liveness probe inside the system namespace. Returns `200` when the API can reach the database, `503` otherwise. Requires a valid token (no specific scope). The unauthenticated infrastructure probe remains at the root `GET /health`.
- [Get single investor](https://developers.dealroom.co/api-reference/investors/get-single-investor.md): Returns the full investor profile by UUID (numeric IDs are not accepted). Includes investor type, stages, deal-size ranges, portfolio summary (top companies, total rounds, total invested), and the underlying entity record. Monetary fields convert to the requested `?currency=`.
- [List funds](https://developers.dealroom.co/api-reference/investors/list-funds.md): The individual fund vehicles this investor firm has raised (e.g. "Fund III", $200M, 2024), newest first. `amount` is the fund size in the requested `?currency=` (default USD); `amount_source` carries the original as-stored amount and native currency.
- [List investor team members](https://developers.dealroom.co/api-reference/investors/list-investor-team-members.md): People associated with the investor firm through the people_entities relationship (partners, executives, and other team members). Supports the same person filter DSL as `/api/data/people`, plus `role` and `is_past` relationship filters. Exposed on the investor lens because investor firms are not alw…
- [List investors](https://developers.dealroom.co/api-reference/investors/list-investors.md): Returns a paginated list of investors (VCs, corporates, angels, etc.) with optional filters and sorting. All entities with is_investor=true are included. Use portfolio_count_tag and/or portfolio_count_location to compute a portfolio match count (number of investments matching specified tags/location…
- [List LP fund positions](https://developers.dealroom.co/api-reference/investors/list-lp-fund-positions.md): Investor firms whose known limited partners include this entity. Each row is an investor-firm entity (not a fund vehicle) with its investor type names.
- [List portfolio companies](https://developers.dealroom.co/api-reference/investors/list-portfolio-companies.md): Portfolio companies this investor has backed (as a round participant), de-duplicated to one row per company with aggregate involvement. Sort by most recent round (default) or latest company valuation. Same data as `/api/data/entities/{id}/investments`.
- [List similar investors](https://developers.dealroom.co/api-reference/investors/list-similar-investors.md): Investors ranked by similarity to this investor, scored by weighted overlap of their investment-portfolio tags — the industries and sectors of the companies each has funded (the legacy investment_categories / investment_sectors signals). Force-sorted by score; supports the full investor filter DSL t…
- [Get single job opening](https://developers.dealroom.co/api-reference/jobs/get-single-job-opening.md): > ⚠ **DATA INCOMPLETE** — Same as `listJobs`: `salary_min`, `salary_max`, `currency`, `department`, and `contract_type` are loaded but intentionally unexposed (<1% coverage), and the table covers active openings only (`expired = 0`).
- [List job openings](https://developers.dealroom.co/api-reference/jobs/list-job-openings.md): > ⚠ **DATA INCOMPLETE** — `salary_min`, `salary_max`, `currency`, `department`, and `contract_type` are loaded from BigQuery but have <1% coverage (Predict Leads, ~99% of volume, does not supply them) and are intentionally not exposed in the API. The jobs table also covers active openings only (`exp…
- [Create landscape](https://developers.dealroom.co/api-reference/landscapes/create-landscape.md): > ⚠ **TABLE NOT LOADED FROM BIGQUERY** — Persists to the user-owned `landscapes` table.
- [Delete landscape](https://developers.dealroom.co/api-reference/landscapes/delete-landscape.md): > ⚠ **TABLE NOT LOADED FROM BIGQUERY** — Hard-deletes a row in the user-owned `landscapes` table.
- [List landscapes](https://developers.dealroom.co/api-reference/landscapes/list-landscapes.md): > ⚠ **TABLE NOT LOADED FROM BIGQUERY** — The `landscapes` and `landscape_entities` tables are user-owned and not populated by the BigQuery loader.
- [Update landscape](https://developers.dealroom.co/api-reference/landscapes/update-landscape.md): > ⚠ **TABLE NOT LOADED FROM BIGQUERY** — Updates the user-owned `landscapes` table.
- [Update landscape entities](https://developers.dealroom.co/api-reference/landscapes/update-landscape-entities.md): > ⚠ **TABLE NOT LOADED FROM BIGQUERY** — Rewrites `landscape_entities` for a landscape that only exists in this environment.
- [Match investors](https://developers.dealroom.co/api-reference/matching/match-investors.md): Returns a ranked list of investors matched to a target company and deal profile. Scoring uses three weighted dimensions — geography, sector, and stage — with weights determined by the `investor_preference` (generalist/specialist) and `local_preference` (local/non_local) parameters. A basic-activity…
- [Get observability config](https://developers.dealroom.co/api-reference/metrics/get-observability-config.md): > ⚠ **STUB ENDPOINT** — Returns the server's observability configuration (OTEL endpoint, instrumentation list). It is NOT a metric data source — use Prometheus / Grafana or `/api/platform/usage/*` for measurements.
- [Get single news article](https://developers.dealroom.co/api-reference/news/get-single-news-article.md): Returns one news article by numeric ID or slug, including its body excerpt, source, publish date, type, monetary amount (for deal articles, converted to the requested `?currency=`), and any linked Dealroom entities.
- [List news articles](https://developers.dealroom.co/api-reference/news/list-news-articles.md): Returns a paginated list of published news articles. Articles can be about deals (VC rounds, IPOs, M&A), insights, events, partnerships, and more. Supports filtering by source, article type, sector, entity, and date range.
- [Get single person](https://developers.dealroom.co/api-reference/people/get-single-person.md): Returns the full person profile by UUID (numeric IDs are not accepted). Covers all person entities (founders, executives, angels, and others). Includes biographic details, professional history, education, and background tags.
- [List career history](https://developers.dealroom.co/api-reference/people/list-career-history.md): The companies and other organizations this person is or was associated with through the people_entities relationship — with their role flags (founder / executive / partner), title(s), and tenure at each. De-duplicated to one row per organization, current roles first. Use `?role=` to restrict to a si…
- [List people](https://developers.dealroom.co/api-reference/people/list-people.md): Returns a paginated list of all person entities (entity_type='person'), including company associations, education history, and professional backgrounds. Supports the same filter syntax as other endpoints.
- [Search entities](https://developers.dealroom.co/api-reference/search/search-entities.md): Searches the entity index by name and returns a flat ranked array of rows; each row carries its `type` (`company` | `investor` | `person` | `university` | `gov_ngo`) plus display fields `website_domain`, `hq_city`, and `hq_country` (any of which may be null). Scope is controlled by the `types=` para…
- [Cancel invitation](https://developers.dealroom.co/api-reference/teams/cancel-invitation.md): Revokes a pending team invitation by ID. The invitee can no longer redeem the invite token. Has no effect on members who have already accepted. Requires the `manage:team-members` scope.
- [Create invitation](https://developers.dealroom.co/api-reference/teams/create-invitation.md): Invite a user to the team by email or user ID. Token-based — the frontend handles delivery.
- [Create team](https://developers.dealroom.co/api-reference/teams/create-team.md): Creates a team and adds the authenticated user as the owner.
- [Delete team](https://developers.dealroom.co/api-reference/teams/delete-team.md): Soft-deletes the team. Requires owner role.
- [Get team](https://developers.dealroom.co/api-reference/teams/get-team.md): Returns team metadata: name, owner, created/updated timestamps, and the caller's role within the team. For the member list, call `/api/platform/teams/{id}/members`. Requires the `read:teams` scope.
- [List pending invitations](https://developers.dealroom.co/api-reference/teams/list-pending-invitations.md): Returns all pending invitations for the team. Requires owner or admin role.
- [List team members](https://developers.dealroom.co/api-reference/teams/list-team-members.md): Returns every confirmed member of the team along with their role (`owner`, `admin`, `member`) and the timestamp they joined. Pending invitations are surfaced separately via `/api/platform/teams/{id}/invitations`. Requires the `read:teams` scope.
- [List teams](https://developers.dealroom.co/api-reference/teams/list-teams.md): Returns all active teams the authenticated user is a member of.
- [Remove team member](https://developers.dealroom.co/api-reference/teams/remove-team-member.md): Remove a member from the team. Owner/admin can remove others; any member can remove themselves.
- [Respond to invitation](https://developers.dealroom.co/api-reference/teams/respond-to-invitation.md): Accept or decline a team invitation by setting its status.
- [Update member role](https://developers.dealroom.co/api-reference/teams/update-member-role.md): Change a team member's role. Requires owner or admin role.
- [Update team](https://developers.dealroom.co/api-reference/teams/update-team.md): Update team name and/or slug. Requires owner or admin role.
- [Timeseries](https://developers.dealroom.co/api-reference/timeseries/timeseries.md): Returns yearly values for a single metric across filtered entities.
- [List transactions](https://developers.dealroom.co/api-reference/transactions/list-transactions.md): Lists company funding-related transactions (rounds, equity events, debt, grants). Supports the structured filter expression syntax shared with `/api/data/entities` and the same `limit` / `offset` / `sort` / `include_total` pagination model.
- [Get single university](https://developers.dealroom.co/api-reference/universities/get-single-university.md): Returns the full university record by UUID (numeric IDs are not accepted), including the `university` sub-object (alumni metrics) alongside the shared entity base fields.
- [List alumni](https://developers.dealroom.co/api-reference/universities/list-alumni.md): People who studied at the university (via people_education), one row per alum with the degree(s) earned and study years here, most recent first. Founder alumni carry `is_founder: true` so callers can surface them.
- [List universities](https://developers.dealroom.co/api-reference/universities/list-universities.md): Returns a paginated list of universities (entities with `organization_subtype = university`). The `university` sub-object carries alumni metrics (founder count, founded/unicorn companies). Supports the full entity filter syntax, sorting, and pagination.
- [List university team members](https://developers.dealroom.co/api-reference/universities/list-university-team-members.md): People associated with the university through the people_entities relationship. Supports the same person filter DSL as `/api/data/people`, plus `role` and `is_past` relationship filters.
- [Get usage summary](https://developers.dealroom.co/api-reference/usage/get-usage-summary.md): Returns total request and error counts per endpoint for the given date range. M2M tokens see their own usage only. Admins can specify a `client_id` to query any client.
- [Get usage timeseries](https://developers.dealroom.co/api-reference/usage/get-usage-timeseries.md): Returns time-bucketed usage data for charts. Supports hourly and daily granularity. Daily aggregates hourly rows at query time via date_trunc.
- [List valuations](https://developers.dealroom.co/api-reference/valuations/list-valuations.md): Returns the cross-entity valuation history. Each row is one company's recorded valuation at a specific year/month, with the valuation source where available. Use `/api/data/entities/:id/valuations` for a single-entity view.
- [Model Context Protocol (MCP)](https://developers.dealroom.co/mintlify/agent-apis/mcp.md): Connect AI agents to Dealroom data through the Dealroom MCP server. Install in Cursor, Claude Desktop, or any MCP-compatible client.
- [Changelog](https://developers.dealroom.co/mintlify/changelog.md): Breaking changes, deprecations, and new features across API versions.
- [Aggregates](https://developers.dealroom.co/mintlify/concepts/aggregates.md): Compute counts, sums, medians, and percentiles grouped by one or more dimensions via the Dealroom aggregate endpoints — heatmaps, top-N rankings, timeseries, and funnels in one API call.
- [Errors](https://developers.dealroom.co/mintlify/concepts/errors.md): How the Dealroom API surfaces errors — response envelope, canonical error-code catalog, and common scenarios with example responses.
- [Filtering](https://developers.dealroom.co/mintlify/concepts/filtering.md): Narrow Dealroom API results with filter expressions. Supports comparison operators, logical AND/OR, and 90+ fields across entities.
- [Known limitations](https://developers.dealroom.co/mintlify/concepts/known-limitations.md): Endpoints and filters that the Dealroom API exposes but are not fully functional today. Read before relying on them in production code.
- [Pagination](https://developers.dealroom.co/mintlify/concepts/pagination.md): Use the `cursor` query parameter to walk through results, with `limit` controlling page size and `include_total` opting into a total count.
- [Rate limits](https://developers.dealroom.co/mintlify/concepts/rate-limits.md): How the Dealroom API rate-limits requests, what a 429 response looks like, and how to request higher limits.
- [API versioning](https://developers.dealroom.co/mintlify/concepts/versioning.md): Learn how the Dealroom API uses Stripe-style date-based versioning to handle breaking changes while keeping existing integrations stable.
- [Account](https://developers.dealroom.co/mintlify/endpoint-overviews/account.md): User profile, authentication introspection, and account settings.
- [Aggregate](https://developers.dealroom.co/mintlify/endpoint-overviews/aggregate.md): Composable single- and multi-metric aggregations across companies, funding rounds, valuations, founders, and investors.
- [API Keys](https://developers.dealroom.co/mintlify/endpoint-overviews/api-keys.md): Self-service API key management. Programmatic (M2M) keys for server-side and Application (PKCE) keys for browser SPAs.
- [Companies](https://developers.dealroom.co/mintlify/endpoint-overviews/companies.md): 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.
- [Discovery](https://developers.dealroom.co/mintlify/endpoint-overviews/discovery.md): API root discovery and functional namespaces.
- [Ecosystems](https://developers.dealroom.co/mintlify/endpoint-overviews/ecosystems.md): Curated entity collections that can be filtered, navigated, and compared. Includes nested landscape resources.
- [Enhancement Requests](https://developers.dealroom.co/mintlify/endpoint-overviews/enhancement-requests.md): User-submitted profile data corrections routed to Dealroom Data Support.
- [Entities](https://developers.dealroom.co/mintlify/endpoint-overviews/entities.md): 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.
- [Filters](https://developers.dealroom.co/mintlify/endpoint-overviews/filters.md): Filter registry discovery and value lookup. Use `/api/reference/filters` to discover available filters per scope and `/api/reference/filters/:key/values` to look up valid values.
- [Founders](https://developers.dealroom.co/mintlify/endpoint-overviews/founders.md): Founder profiles with company associations and education history. Subset of entities where `is_founder = true`.
- [Funding Analytics](https://developers.dealroom.co/mintlify/endpoint-overviews/funding-analytics.md): Purpose-built analytics: 2D heatmaps, round transitions, capital funnels.
- [Funds](https://developers.dealroom.co/mintlify/endpoint-overviews/funds.md): 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 am…
- [Government & NGO](https://developers.dealroom.co/mintlify/endpoint-overviews/government-and-ngo.md): Government bodies and NGOs — the `organization_subtype = gov_ngo` subset of entities.
- [Health](https://developers.dealroom.co/mintlify/endpoint-overviews/health.md): Liveness probe (public, unauthenticated).
- [Investors](https://developers.dealroom.co/mintlify/endpoint-overviews/investors.md): 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`.
- [Jobs](https://developers.dealroom.co/mintlify/endpoint-overviews/jobs.md): Active job openings posted by companies, with hiring-trend signals.
- [Landscapes](https://developers.dealroom.co/mintlify/endpoint-overviews/landscapes.md): Saved entity lists within an ecosystem (e.g. "top fintech in NL").
- [Matching](https://developers.dealroom.co/mintlify/endpoint-overviews/matching.md): Investor matching tool: ranked investor recommendations for a given deal profile.
- [Metrics](https://developers.dealroom.co/mintlify/endpoint-overviews/metrics.md): Service observability metrics (OpenTelemetry configuration and runtime counters).
- [News](https://developers.dealroom.co/mintlify/endpoint-overviews/news.md): Curated news articles about companies, funds, deals, sectors, and events.
- [People](https://developers.dealroom.co/mintlify/endpoint-overviews/people.md): Person profiles (founders, executives, angels, and others). Subset of entities where `entity_type = 'person'`. Same response shape as founders, with company associations, education, and backgrounds.
- [Search](https://developers.dealroom.co/mintlify/endpoint-overviews/search.md): Cross-resource fuzzy search across companies, investors, people, universities, and government & NGO bodies.
- [Teams](https://developers.dealroom.co/mintlify/endpoint-overviews/teams.md): Team membership and invitation management.
- [Timeseries](https://developers.dealroom.co/mintlify/endpoint-overviews/timeseries.md): Yearly entity metrics (employees, revenue, valuation).
- [Transactions](https://developers.dealroom.co/mintlify/endpoint-overviews/transactions.md): Funding rounds, equity events, debt, grants, exits, and other company-level financial events.
- [Universities](https://developers.dealroom.co/mintlify/endpoint-overviews/universities.md): University profiles — the `organization_subtype = university` subset of entities. The `university` sub-object carries alumni metrics.
- [Usage](https://developers.dealroom.co/mintlify/endpoint-overviews/usage.md): Request-count usage analytics per API key for billing and introspection.
- [Valuations](https://developers.dealroom.co/mintlify/endpoint-overviews/valuations.md): Company valuation history by year and month.
- [Portfolio Dashboard](https://developers.dealroom.co/mintlify/examples/portfolio-dashboard.md): Build a branded VC portfolio monitoring dashboard with React, D3, and the Dealroom API — runs entirely in the browser using Auth0 Universal Login
- [Top fintech startups](https://developers.dealroom.co/mintlify/examples/top-startups.md): A 20-line recipe that fetches the 10 most-funded fintech startups via the Dealroom API. Token exchange + filter + sort + limit, in cURL, Node.js, and Python.
- [Authentication](https://developers.dealroom.co/mintlify/getting-started/authentication.md): Get started in under a minute with Node.js or Python SDKs, or use raw HTTP. Create API keys, exchange credentials for Bearer tokens, and authenticate requests.
- [Quickstart](https://developers.dealroom.co/mintlify/getting-started/quickstart.md): Get started with the Dealroom API in under 5 minutes. Obtain an access token, make your first request, and explore entity search results.
- [Dealroom API](https://developers.dealroom.co/mintlify/index.md): Access startup, investor, and funding round data for 5M+ companies via the Dealroom REST API. Query entities, valuations, and taxonomy data programmatically.
- [Ecosystem](https://developers.dealroom.co/mintlify/objects/ecosystem.md): Field reference for the Ecosystem object.
- [Entity](https://developers.dealroom.co/mintlify/objects/entity.md): Field reference for the Entity object.
- [Founder / Person](https://developers.dealroom.co/mintlify/objects/founder.md): Field reference for the Founder / Person object.
- [Fund](https://developers.dealroom.co/mintlify/objects/fund.md): Field reference for the Fund object.
- [Investor](https://developers.dealroom.co/mintlify/objects/investor.md): Field reference for the Investor object.
- [Job](https://developers.dealroom.co/mintlify/objects/job.md): Field reference for the Job object.
- [Landscape](https://developers.dealroom.co/mintlify/objects/landscape.md): Field reference for the Landscape object.
- [News Article](https://developers.dealroom.co/mintlify/objects/news-article.md): Field reference for the News Article object.
- [Transaction](https://developers.dealroom.co/mintlify/objects/transaction.md): Field reference for the Transaction object.
- [Valuation](https://developers.dealroom.co/mintlify/objects/valuation.md): Field reference for the Valuation object.
- [Filters & Sorting](https://developers.dealroom.co/mintlify/references/filters-and-sorting.md): Complete reference of available filters and sort keys for each API scope.

## OpenAPI Specs

- [openapi](https://developers.dealroom.co/mintlify/openapi.yaml)