Dealroom API API

# checkov:skip=CKV_OPENAPI_5: /health intentionally opts out of global auth via security: []
# checkov:skip=CKV_OPENAPI_21: array schemas without maxItems are intentional for telemetry shapes
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.
x-tagGroups:
  - name: Data
    tags:
      - Entities
      - Companies
      - Universities
      - Government & NGO
      - Transactions
      - Valuations
      - Investors
      - Funds
      - People
      - Founders
      - News
      - Jobs
      - Search
  - name: Analytics
    tags:
      - Aggregate
      - Timeseries


# --- truncated at 32 KB (993 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dealroom/refs/heads/main/openapi/_original/dealroom-api-openapi.yml