> ## 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 portfolio companies

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



## OpenAPI

````yaml /mintlify/openapi.yaml get /api/data/investors/{id}/portfolio
openapi: 3.1.0
info:
  title: Dealroom API
  version: '2026-07-06'
  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-next.dealroom.co
    description: Production
  - url: https://api-next.beta.dealroom.co
    description: Beta
  - url: https://api-next.staging.dealroom.dev
    description: Staging
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 year and month.
  - 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 backgrounds.
  - 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, funding
      rounds, valuations, founders, and investors.
  - name: Funding Analytics
    description: 'Purpose-built analytics: 2D heatmaps, round transitions, capital funnels.'
  - name: Timeseries
    description: Yearly entity metrics (employees, revenue, valuation).
  - name: Matching
    description: >-
      Investor matching tool: ranked investor recommendations for a given deal
      profile.
  - name: Filters
    description: >-
      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.
  - name: Account
    description: User profile, authentication introspection, and account settings.
  - name: API Keys
    description: >-
      Self-service API key management. Programmatic (M2M) keys for server-side
      and Application (PKCE) keys for browser SPAs.
  - name: Teams
    description: Team membership and invitation management.
  - name: Usage
    description: Request-count usage analytics per API key for billing and introspection.
  - name: Metrics
    description: >-
      Service observability metrics (OpenTelemetry configuration and runtime
      counters).
  - name: Health
    description: Liveness probe (public, unauthenticated).
  - name: Search
    description: >-
      Cross-resource fuzzy search across companies, investors, people,
      universities, and government & NGO bodies.
  - name: Ecosystems
    description: >-
      Curated entity collections that can be filtered, navigated, and compared.
      Includes nested landscape resources.
  - name: Landscapes
    description: Saved entity lists within an ecosystem (e.g. "top fintech in NL").
  - name: Enhancement Requests
    description: User-submitted profile data corrections routed to Dealroom Data Support.
paths:
  /api/data/investors/{id}/portfolio:
    get:
      tags:
        - Investors
      summary: List portfolio companies
      description: >-
        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`.
      operationId: investorPortfolio
      parameters:
        - schema:
            type: string
            minLength: 1
            format: uuid
            description: Stable UUID of the entity. Numeric ids are not accepted.
            example: 345d1ab6-33df-4759-9e17-0d0c0ec9ab1c
          required: true
          name: id
          in: path
        - schema:
            type: integer
            description: Number of results to return (1-500, default 100)
            format: int32
            minimum: 1
            maximum: 500
            default: 100
            example: 100
          required: false
          name: limit
          in: query
        - schema:
            type: integer
            description: >-
              Number of results to skip before returning data. Combine with
              `limit` for offset-based pagination.
            format: int32
            minimum: 0
            default: 0
            example: 0
          required: false
          name: offset
          in: query
        - schema:
            type: string
            enum:
              - '-last_round_date'
              - '-latest_valuation'
            description: >-
              Sort order for portfolio companies. `-last_round_date` (default)
              returns the most recently backed companies first;
              `-latest_valuation` returns the highest-valuation companies first
              (unknown valuations last).
            example: '-latest_valuation'
          required: false
          name: sort
          in: query
        - schema:
            type: string
            description: >-
              ISO 4217 currency code for monetary field conversion. Defaults to
              USD.
            example: EUR
          required: false
          name: currency
          in: query
      responses:
        '200':
          description: Investor portfolio
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EntityInvestmentsResponse'
        '400':
          description: Invalid entity ID
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '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'
        '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'
      security:
        - oauth2:
            - read:investors
        - bearerAuth:
            - read:investors
components:
  schemas:
    EntityInvestmentsResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/EntityInvestmentItem'
        page:
          type: object
          properties:
            total:
              type: number
            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.
            capped:
              type: boolean
              description: >-
                True when the requested page size was reduced to the
                per-tier/ecosystem row cap.
            tier:
              type: string
              enum:
                - anonymous
                - free
                - premium
              description: >-
                The access tier applied to this request (anonymous, free,
                premium).
            ecosystem:
              type:
                - string
                - 'null'
              description: >-
                Slug of the active ecosystem subdomain, or null when none is in
                scope.
          required:
            - limit
            - offset
            - next_cursor
            - prev_cursor
        currency:
          type: string
          description: >-
            Currency the portfolio-company monetary fields are expressed in
            (default USD).
          example: EUR
      required:
        - data
        - page
        - currency
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            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
          required:
            - code
            - message
      required:
        - error
    EntityInvestmentItem:
      type: object
      properties:
        company:
          type: object
          properties:
            uuid:
              type: string
              description: Stable UUID of the portfolio company.
              example: 345d1ab6-33df-4759-9e17-0d0c0ec9ab1c
            name:
              type:
                - string
                - 'null'
            image:
              type:
                - string
                - 'null'
            tagline:
              type:
                - string
                - 'null'
            status:
              type:
                - string
                - 'null'
              description: >-
                `company_status`: `operational`, `acquired`, `closed`,
                `low_activity`, or null when unknown.
            total_funding:
              type:
                - number
                - 'null'
              description: >-
                Portfolio company's all-time total funding raised, in the
                response `currency`.
            latest_valuation:
              type:
                - number
                - 'null'
              description: >-
                Portfolio company's most recent known valuation, in the response
                `currency`.
            launch_year:
              type:
                - number
                - 'null'
              description: Year the portfolio company was founded.
              example: 2018
            hq_city:
              type:
                - string
                - 'null'
              description: Portfolio company's HQ city.
              example: Berlin
            hq_country:
              type:
                - string
                - 'null'
              description: Portfolio company's HQ country.
              example: Germany
            signal_rating:
              type:
                - number
                - 'null'
              description: Dealroom signal rating (0–100) for the portfolio company.
              example: 84
          required:
            - uuid
            - name
            - image
            - tagline
            - status
            - total_funding
            - latest_valuation
            - launch_year
            - hq_city
            - hq_country
            - signal_rating
          description: >-
            The portfolio company that raised the round(s) this entity invested
            in.
        is_lead:
          type: boolean
          description: True when this entity led at least one round in the company.
        rounds_count:
          type: number
          description: Number of the company's rounds this entity participated in.
          example: 2
        last_round_year:
          type:
            - number
            - 'null'
          description: Year of the most recent round this entity invested in.
          example: 2023
      required:
        - company
        - is_lead
        - rounds_count
        - last_round_year
  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.
      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:funding-analytics: Grant the read:funding-analytics permission
            read:ecosystems: Grant the read:ecosystems permission
            write:ecosystems: Grant the write:ecosystems permission
            delete:ecosystems: Grant the delete:ecosystems permission
            write:landscapes: Grant the write:landscapes permission
            delete:landscapes: Grant the delete:landscapes permission
            read:metrics: Grant the read:metrics permission
            create:api-keys: Grant the create:api-keys permission
            read:api-keys: Grant the read:api-keys permission
            delete:api-keys: Grant the delete:api-keys permission
            admin:api-keys: Grant the admin:api-keys permission
            read:usage: Grant the read:usage permission
            read:news: Grant the read:news permission
            read:jobs: Grant the read:jobs permission
            read:people: Grant the read:people permission
            read:teams: Grant the read:teams permission
            write:teams: Grant the write:teams permission
            delete:teams: Grant the delete:teams permission
            manage:team-members: Grant the manage:team-members permission
            read:search: Grant the read:search permission
            write:ai-features: Grant the write:ai-features permission

````