Skip to main content
GET
/
api
/
analytics
/
matching
/
investors
Match investors
curl --request GET \
  --url https://api-next.dealroom.co/api/analytics/matching/investors \
  --header 'Authorization: Bearer <token>'
{
  "investors": [
    {
      "investor": {
        "uuid": "0f1e3a3e-2c2c-4f0d-9c9d-1d1e2a3b4c5d",
        "type": "organization",
        "organization_subtype": "investor",
        "name": "Sequoia Capital",
        "tagline": "The legendary venture firm.",
        "image": "https://images.dealroom.co/logos/sequoia.png",
        "dealroom_url": "https://app.dealroom.co/investors/sequoia-capital",
        "website": "https://www.sequoiacap.com",
        "website_domain": "sequoiacap.com",
        "linkedin_url": "https://www.linkedin.com/company/sequoia-capital",
        "twitter_url": "https://twitter.com/sequoia",
        "crunchbase_url": "https://www.crunchbase.com/organization/sequoia-capital",
        "instagram": "sequoiacapital",
        "angellist": "https://angel.co/sequoia",
        "launch_year": 1972,
        "employee_count": 250,
        "investor_rank": 42,
        "hq_country": "United States",
        "hq_city": "Menlo Park",
        "lat": 37.4533,
        "lon": -122.1817,
        "founding_country": "United States",
        "founding_city": "Menlo Park",
        "founding_lat": 37.4533,
        "founding_lon": -122.1817,
        "exit_count": 123,
        "exit_total_value": 123,
        "exit_pct": 123,
        "portfolio_total_valuation": 123,
        "tags": [
          {
            "id": 123,
            "name": "<string>",
            "type": "<string>"
          }
        ],
        "investor_types": [
          {
            "id": 123,
            "name": "<string>",
            "code": "<string>"
          }
        ],
        "investor_stages": [
          {
            "id": 123,
            "name": "<string>",
            "code": "<string>"
          }
        ],
        "deal_sizes": {
          "min": 123,
          "max": 123
        },
        "investments": {
          "total_count": 123,
          "total_invested": 123,
          "preferred_round": "<string>",
          "last_investor_round_year": 123,
          "last_investor_round_month": 123
        },
        "portfolio": {
          "companies": 123,
          "total_rounds": 123,
          "match_count": 123,
          "match_invested": 123,
          "top_companies": [
            {
              "uuid": "345d1ab6-33df-4759-9e17-0d0c0ec9ab1c",
              "name": "<string>",
              "tagline": "<string>",
              "image": "<string>"
            }
          ]
        }
      },
      "rank": 1,
      "match_tier": "strong",
      "total_score": 100,
      "basic_activity": 1,
      "dimension_scores": {
        "geography": {
          "raw": 123,
          "value": 3,
          "weight": 123
        },
        "sector": {
          "raw": 123,
          "value": 3,
          "weight": 123
        },
        "stage": {
          "raw": 123,
          "value": 3,
          "weight": 123
        },
        "activity": {
          "raw": 123,
          "value": 3,
          "weight": 123
        }
      },
      "match_reasons": [
        "3 matching rounds in target country",
        "Invests at SERIES A stage"
      ],
      "weights_applied": {
        "geography": 123,
        "sector": 123,
        "stage": 123
      },
      "evidence": {
        "hq_city_vc_rounds_2023_plus": 123,
        "hq_city_vc_rounds_2025_plus": 123,
        "hq_country_vc_rounds_2023_plus": 123,
        "hq_country_vc_rounds_2025_plus": 123,
        "hq_region_vc_rounds_2023_plus": 123,
        "hq_region_vc_rounds_2025_plus": 123,
        "global_vc_rounds_2023_plus": 123,
        "global_vc_rounds_2025_plus": 123,
        "global_vc_rounds_12mo": 123,
        "global_vc_companies_12mo": 123,
        "sector_tags_experience_match_count": 123,
        "global_vc_rounds_industries_2023_plus": 123,
        "global_vc_rounds_industries_2025_plus": 123,
        "global_vc_rounds_sub_industries_2023_plus": 123,
        "global_vc_rounds_sub_industries_2025_plus": 123,
        "global_vc_rounds_client_focus_2023_plus": 123,
        "global_vc_rounds_client_focus_2025_plus": 123,
        "global_vc_rounds_business_model_2023_plus": 123,
        "global_vc_rounds_business_model_2025_plus": 123,
        "global_vc_rounds_deep_tech_2023_plus": 123,
        "global_vc_rounds_deep_tech_2025_plus": 123,
        "global_vc_rounds_blockchain_2023_plus": 123,
        "global_vc_rounds_blockchain_2025_plus": 123,
        "hq_city_target_vc_rounds_2023_plus": 123,
        "hq_city_target_vc_rounds_2025_plus": 123,
        "hq_country_target_vc_rounds_2023_plus": 123,
        "hq_country_target_vc_rounds_2025_plus": 123,
        "hq_region_target_vc_rounds_2023_plus": 123,
        "hq_region_target_vc_rounds_2025_plus": 123,
        "global_target_vc_rounds_2023_plus": 123,
        "global_target_vc_rounds_2025_plus": 123
      }
    }
  ],
  "meta": {
    "total_candidates": 342,
    "weights_applied": {
      "geography": 123,
      "sector": 123,
      "stage": 123
    }
  }
}

Authorizations

​
Authorization
string
header
required

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.

Query Parameters

​
company_id
string<uuid>
required

UUID of the target company.

Example:

"345d1ab6-33df-4759-9e17-0d0c0ec9ab1c"

​
target_round
enum<string>
required

Round stage the company is raising.

Available options:
PRE-SEED,
SEED,
SERIES A,
SERIES B,
SERIES C+
Example:

"SERIES A"

​
min_round_size_usd
number
required

Lower bound of the target round size in USD.

Example:

"10000000"

​
max_round_size_usd
number
required

Upper bound of the target round size in USD.

Example:

"20000000"

​
require_lead_investor
boolean

When true, only count rounds where the investor was a lead.

Example:

"false"

​
investor_preference
enum<string>
required

Whether the founder prefers a generalist or a sector-specialist investor. Shifts scoring weights toward geography or sector accordingly.

Available options:
generalist,
specialist
Example:

"specialist"

​
local_preference
enum<string>
required

Whether the founder prefers a local (same city/country) or non-local investor. Shifts scoring weights toward geography or stage accordingly.

Available options:
local,
non_local
Example:

"local"

​
limit
integer
default:50

Number of matched investors to return (1–100, default 50).

Required range: 1 <= x <= 100
Example:

"50"

​
filter_location_name
string

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"

​
filter_location_type
string

Location granularity: continent, country, state, city, or region. Controls which HQ field is compared against filter_location_name.

Example:

"country"

​
filter_investor_types
string

Comma-separated investor type codes to include (e.g. vc,accelerator). Filters the candidate pool before ranking.

Example:

"vc"

Response

Ranked list of matched investors with scoring breakdown

​
investors
object[]
required
​
meta
object
required