> ## 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. # Match investors > 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 multiplier (1 / 0.75 / 0) is applied before normalisation so that recently inactive investors rank lower. The top investor in the result set always receives a `total_score` of 100. ## OpenAPI ````yaml /mintlify/openapi.yaml get /api/analytics/matching/investors 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/analytics/matching/investors: get: tags: - Matching summary: Match investors description: >- 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 multiplier (1 / 0.75 / 0) is applied before normalisation so that recently inactive investors rank lower. The top investor in the result set always receives a `total_score` of 100. operationId: matchInvestors parameters: - schema: type: string description: UUID of the target company. format: uuid example: 345d1ab6-33df-4759-9e17-0d0c0ec9ab1c required: true name: company_id in: query - schema: type: string enum: - PRE-SEED - SEED - SERIES A - SERIES B - SERIES C+ description: Round stage the company is raising. example: SERIES A required: true name: target_round in: query - schema: type: number description: Lower bound of the target round size in USD. example: '10000000' required: true name: min_round_size_usd in: query - schema: type: number description: Upper bound of the target round size in USD. example: '20000000' required: true name: max_round_size_usd in: query - schema: type: boolean description: When true, only count rounds where the investor was a lead. example: 'false' required: false name: require_lead_investor in: query - schema: type: string enum: - generalist - specialist description: >- Whether the founder prefers a generalist or a sector-specialist investor. Shifts scoring weights toward geography or sector accordingly. example: specialist required: true name: investor_preference in: query - schema: type: string enum: - local - non_local description: >- Whether the founder prefers a local (same city/country) or non-local investor. Shifts scoring weights toward geography or stage accordingly. example: local required: true name: local_preference in: query - schema: type: integer description: Number of matched investors to return (1–100, default 50). minimum: 1 maximum: 100 default: 50 example: '50' required: false name: limit in: query - schema: type: string description: >- Location name to filter by. Matched against the investor HQ field that corresponds to filter_location_type (continent → continent, country → country, state → state, city → city, region → mapped Dealroom region). example: Netherlands required: false name: filter_location_name in: query - schema: type: string description: >- Location granularity: continent, country, state, city, or region. Controls which HQ field is compared against filter_location_name. example: country required: false name: filter_location_type in: query - schema: type: string description: >- Comma-separated investor type codes to include (e.g. vc,accelerator). Filters the candidate pool before ranking. example: vc required: false name: filter_investor_types in: query responses: '200': description: Ranked list of matched investors with scoring breakdown content: application/json: schema: $ref: '#/components/schemas/MatchingInvestorsResponse' '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' '422': description: Validation error — missing or invalid query parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - oauth2: - read:investors - bearerAuth: - read:investors components: schemas: MatchingInvestorsResponse: type: object properties: investors: type: array items: $ref: '#/components/schemas/MatchedInvestor' meta: type: object properties: total_candidates: type: integer description: Total investors returned by the query before limiting. example: 342 weights_applied: type: object properties: geography: type: number description: Geography dimension weight (0–1). sector: type: number description: Sector dimension weight (0–1). stage: type: number description: Stage dimension weight (0–1). required: - geography - sector - stage required: - total_candidates - weights_applied required: - investors - meta 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 MatchedInvestor: type: object properties: investor: allOf: - $ref: '#/components/schemas/Investor' - description: >- Full investor profile — same shape as GET /api/data/investors list items. rank: type: integer exclusiveMinimum: 0 example: 1 match_tier: type: string enum: - strong - good - other example: strong total_score: type: integer minimum: 0 maximum: 100 description: 0–100 score normalised so the top investor in the result set = 100. example: 100 basic_activity: type: number description: >- Activity multiplier applied before normalisation: 1 (active since 2025), 0.75 (active since 2023 only), 0 (inactive). example: 1 dimension_scores: type: object properties: geography: type: object properties: raw: type: number description: Normalised 0–1 score for this dimension. value: type: integer minimum: 1 maximum: 5 description: 'Display value: 1–5 dots.' weight: type: number description: >- Weight applied from the profile (0–1). Activity is display-only (weight 0). required: - raw - value - weight sector: type: object properties: raw: type: number description: Normalised 0–1 score for this dimension. value: type: integer minimum: 1 maximum: 5 description: 'Display value: 1–5 dots.' weight: type: number description: >- Weight applied from the profile (0–1). Activity is display-only (weight 0). required: - raw - value - weight stage: type: object properties: raw: type: number description: Normalised 0–1 score for this dimension. value: type: integer minimum: 1 maximum: 5 description: 'Display value: 1–5 dots.' weight: type: number description: >- Weight applied from the profile (0–1). Activity is display-only (weight 0). required: - raw - value - weight activity: type: object properties: raw: type: number description: Normalised 0–1 score for this dimension. value: type: integer minimum: 1 maximum: 5 description: 'Display value: 1–5 dots.' weight: type: number description: >- Weight applied from the profile (0–1). Activity is display-only (weight 0). required: - raw - value - weight required: - geography - sector - stage - activity match_reasons: type: array items: type: string description: Up to 3 human-readable reasons explaining the match. example: - 3 matching rounds in target country - Invests at SERIES A stage weights_applied: type: object properties: geography: type: number description: Geography dimension weight (0–1). sector: type: number description: Sector dimension weight (0–1). stage: type: number description: Stage dimension weight (0–1). required: - geography - sector - stage evidence: type: object properties: hq_city_vc_rounds_2023_plus: type: integer hq_city_vc_rounds_2025_plus: type: integer hq_country_vc_rounds_2023_plus: type: integer hq_country_vc_rounds_2025_plus: type: integer hq_region_vc_rounds_2023_plus: type: integer hq_region_vc_rounds_2025_plus: type: integer global_vc_rounds_2023_plus: type: integer global_vc_rounds_2025_plus: type: integer global_vc_rounds_12mo: type: integer description: Global VC rounds in the trailing 12 months, recomputed nightly. global_vc_companies_12mo: type: integer description: >- Distinct portfolio companies with a VC round in the trailing 12 months, recomputed nightly. sector_tags_experience_match_count: type: - integer - 'null' global_vc_rounds_industries_2023_plus: type: - integer - 'null' global_vc_rounds_industries_2025_plus: type: - integer - 'null' global_vc_rounds_sub_industries_2023_plus: type: - integer - 'null' global_vc_rounds_sub_industries_2025_plus: type: - integer - 'null' global_vc_rounds_client_focus_2023_plus: type: - integer - 'null' global_vc_rounds_client_focus_2025_plus: type: - integer - 'null' global_vc_rounds_business_model_2023_plus: type: - integer - 'null' global_vc_rounds_business_model_2025_plus: type: - integer - 'null' global_vc_rounds_deep_tech_2023_plus: type: - integer - 'null' global_vc_rounds_deep_tech_2025_plus: type: - integer - 'null' global_vc_rounds_blockchain_2023_plus: type: - integer - 'null' global_vc_rounds_blockchain_2025_plus: type: - integer - 'null' hq_city_target_vc_rounds_2023_plus: type: integer hq_city_target_vc_rounds_2025_plus: type: integer hq_country_target_vc_rounds_2023_plus: type: integer hq_country_target_vc_rounds_2025_plus: type: integer hq_region_target_vc_rounds_2023_plus: type: integer hq_region_target_vc_rounds_2025_plus: type: integer global_target_vc_rounds_2023_plus: type: integer global_target_vc_rounds_2025_plus: type: integer required: - hq_city_vc_rounds_2023_plus - hq_city_vc_rounds_2025_plus - hq_country_vc_rounds_2023_plus - hq_country_vc_rounds_2025_plus - hq_region_vc_rounds_2023_plus - hq_region_vc_rounds_2025_plus - global_vc_rounds_2023_plus - global_vc_rounds_2025_plus - global_vc_rounds_12mo - global_vc_companies_12mo - sector_tags_experience_match_count - global_vc_rounds_industries_2023_plus - global_vc_rounds_industries_2025_plus - global_vc_rounds_sub_industries_2023_plus - global_vc_rounds_sub_industries_2025_plus - global_vc_rounds_client_focus_2023_plus - global_vc_rounds_client_focus_2025_plus - global_vc_rounds_business_model_2023_plus - global_vc_rounds_business_model_2025_plus - global_vc_rounds_deep_tech_2023_plus - global_vc_rounds_deep_tech_2025_plus - global_vc_rounds_blockchain_2023_plus - global_vc_rounds_blockchain_2025_plus - hq_city_target_vc_rounds_2023_plus - hq_city_target_vc_rounds_2025_plus - hq_country_target_vc_rounds_2023_plus - hq_country_target_vc_rounds_2025_plus - hq_region_target_vc_rounds_2023_plus - hq_region_target_vc_rounds_2025_plus - global_target_vc_rounds_2023_plus - global_target_vc_rounds_2025_plus description: Raw activity counts used as scoring inputs. required: - investor - rank - match_tier - total_score - basic_activity - dimension_scores - match_reasons - weights_applied - evidence Investor: type: object properties: uuid: type: string description: >- Stable UUID of the investor. This is the sole public identifier; numeric ids are not accepted. example: 0f1e3a3e-2c2c-4f0d-9c9d-1d1e2a3b4c5d type: type: string enum: - organization - person description: >- Top-level entity type — `organization` for firms/funds, `person` for angel investors. example: organization organization_subtype: type: - string - 'null' enum: - company - university - gov_ngo - investor description: >- Organization subtype (`company`, `university`, `gov_ngo`, `investor`). Null for person (angel) investors. Use this to link to the correct profile route. The value `fund` is returned only for API versions before 2026-06-19. example: investor name: type: string description: Display name of the investor. example: Sequoia Capital tagline: type: - string - 'null' description: Short one-line description of the investor. example: The legendary venture firm. image: type: - string - 'null' description: Absolute URL to the investor's logo. example: https://images.dealroom.co/logos/sequoia.png dealroom_url: type: - string - 'null' description: Canonical URL on app.dealroom.co. example: https://app.dealroom.co/investors/sequoia-capital website: type: - string - 'null' description: Public website URL. example: https://www.sequoiacap.com website_domain: type: - string - 'null' description: Bare website domain (no protocol). example: sequoiacap.com linkedin_url: type: - string - 'null' description: LinkedIn profile URL. example: https://www.linkedin.com/company/sequoia-capital twitter_url: type: - string - 'null' description: Twitter/X profile URL. example: https://twitter.com/sequoia crunchbase_url: type: - string - 'null' description: Crunchbase profile URL. example: https://www.crunchbase.com/organization/sequoia-capital instagram: type: - string - 'null' description: Instagram handle. example: sequoiacapital angellist: type: - string - 'null' description: AngelList profile URL. example: https://angel.co/sequoia launch_year: type: - number - 'null' description: Year the firm was founded. example: 1972 employee_count: type: - number - 'null' description: Latest known employee headcount. example: 250 investor_rank: type: - number - 'null' description: Dealroom investor rank (lower = better). Null if unranked. example: 42 hq_country: type: - string - 'null' description: HQ country name. example: United States hq_city: type: - string - 'null' description: HQ city. example: Menlo Park lat: type: - number - 'null' description: HQ latitude (decimal degrees). example: 37.4533 lon: type: - number - 'null' description: HQ longitude (decimal degrees). example: -122.1817 founding_country: type: - string - 'null' description: Country name where the investor was founded. example: United States founding_city: type: - string - 'null' description: City where the investor was founded. example: Menlo Park founding_lat: type: - number - 'null' description: Founding location latitude (decimal degrees). example: 37.4533 founding_lon: type: - number - 'null' description: Founding location longitude (decimal degrees). example: -122.1817 tags: type: array items: type: object properties: id: type: number name: type: string type: type: string required: - id - name - type investor_types: type: array items: type: object properties: id: type: number name: type: string code: type: string required: - id - name - code investor_stages: type: array items: type: object properties: id: type: number name: type: string code: type: string required: - id - name - code deal_sizes: type: object properties: min: type: - number - 'null' max: type: - number - 'null' required: - min - max investments: type: object properties: total_count: type: - number - 'null' total_invested: type: - number - 'null' preferred_round: type: - string - 'null' last_investor_round_year: type: - number - 'null' last_investor_round_month: type: - number - 'null' required: - total_count - total_invested - preferred_round - last_investor_round_year - last_investor_round_month portfolio: type: object properties: companies: type: - number - 'null' total_rounds: type: - number - 'null' match_count: type: - number - 'null' match_invested: type: - number - 'null' top_companies: type: array items: type: object properties: uuid: type: string description: Stable UUID of the portfolio company. example: 345d1ab6-33df-4759-9e17-0d0c0ec9ab1c name: type: string tagline: type: - string - 'null' image: type: - string - 'null' required: - uuid - name - tagline - image required: - companies - total_rounds exit_count: type: - number - 'null' description: Number of portfolio companies that have had an exit round. exit_total_value: type: - number - 'null' description: >- Total value of all exit rounds for portfolio companies, in the response `currency`. exit_pct: type: - number - 'null' description: Percentage of portfolio companies that have exited. portfolio_total_valuation: type: - number - 'null' description: >- Sum of the latest known valuations of all portfolio companies, in the response `currency`. required: - uuid - type - organization_subtype - name - tagline - image - dealroom_url - website - website_domain - linkedin_url - twitter_url - crunchbase_url - instagram - angellist - launch_year - employee_count - investor_rank - hq_country - hq_city - lat - lon - founding_country - founding_city - founding_lat - founding_lon - exit_count - exit_total_value - exit_pct - portfolio_total_valuation 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 ````