curl --request GET \
--url https://api.dealroom.app/analytics/matching/investors \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.dealroom.app/analytics/matching/investors"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.dealroom.app/analytics/matching/investors', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.dealroom.app/analytics/matching/investors",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.dealroom.app/analytics/matching/investors"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.dealroom.app/analytics/matching/investors")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.dealroom.app/analytics/matching/investors")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"investor": {
"uuid": "345d1ab6-33df-4759-9e17-0d0c0ec9ab1c",
"type": "person",
"subtype": null,
"name": "Patrick Collison",
"tagline": "<string>",
"about": "<string>",
"image": "<string>",
"dealroom_url": "<string>",
"links": {
"linkedin": "<string>",
"twitter": "<string>",
"angellist": "<string>",
"crunchbase": "<string>"
},
"locations": [
{
"role": "hq",
"city": {
"id": 123,
"name": "<string>"
},
"state": {
"id": 123,
"name": "<string>"
},
"country": {
"id": 123,
"name": "<string>"
},
"continent": {
"id": 123,
"name": "<string>"
},
"lat": 123,
"lon": 123
}
],
"roles": [
"founder"
],
"classifications": [
"startup"
],
"taxonomy": [
{
"id": 123,
"name": "<string>",
"type": "sector"
}
],
"gender": "male",
"signal_rating": 123,
"investor": {
"rank": 123,
"types": [
{
"id": 123,
"name": "<string>",
"code": "<string>"
}
],
"stages": [
{
"id": 123,
"name": "<string>",
"code": "<string>"
}
],
"deal_size": {
"min": 123,
"max": 123
},
"investments": {
"count": 123,
"total_invested": 123,
"preferred_round": "<string>",
"last_round_date": "2024-03"
},
"portfolio": {
"rounds_count": 123,
"total_valuation": 123,
"companies": {
"total": 123,
"sort": "-last_round_date",
"items": [
{
"is_lead": true,
"rounds_count": 123,
"last_round_date": "2024-03",
"company": {
"uuid": "<string>",
"type": "organization",
"subtype": "company",
"name": "<string>",
"image": "<string>",
"dealroom_url": "<string>"
}
}
]
}
},
"exits": {
"count": 123,
"total_value": 123,
"pct": 123
},
"match": {
"companies_count": 123,
"invested": 123
},
"round_match": {
"count": 123,
"total": 123,
"pct": 123
}
},
"founded_companies": {
"count": 123,
"total_funding": 123
},
"career": {
"total": 123,
"sort": "-is_founder,is_past,-start_date",
"items": [
{
"raw_title": "<string>",
"titles": [
"<string>"
],
"is_founder": true,
"is_executive": true,
"is_partner": true,
"is_past": true,
"start_date": "2024-03",
"end_date": "2024-03",
"company": {
"uuid": "<string>",
"type": "organization",
"subtype": "company",
"name": "<string>",
"image": "<string>",
"dealroom_url": "<string>"
}
}
]
},
"education": {
"total": 123,
"sort": "-start_date",
"items": [
{
"degree": {
"id": 123,
"name": "<string>"
},
"majors": [
{
"id": 123,
"name": "<string>"
}
],
"start_date": "2024-03",
"end_date": "2024-03",
"university": {
"uuid": "<string>",
"type": "organization",
"subtype": "company",
"name": "<string>",
"image": "<string>",
"dealroom_url": "<string>"
}
}
]
},
"available": [
"founded_companies"
],
"added_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
},
"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_main_hub_vc_rounds_2023_plus": 123,
"hq_main_hub_vc_rounds_2025_plus": 123,
"hq_state_vc_rounds_2023_plus": 123,
"hq_state_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_matches_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_main_hub_target_vc_rounds_2023_plus": 123,
"hq_main_hub_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
}
}
],
"currency": "EUR",
"meta": {
"total": 342,
"weights_applied": {
"geography": 123,
"sector": 123,
"stage": 123
},
"local_area": {
"type": "main_hub",
"name": "Greater Pittsburgh"
}
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "The request was malformed or failed validation.",
"details": null
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required — provide a valid bearer token.",
"details": null
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "<string>",
"details": [
{
"path": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "FORBIDDEN",
"message": "You do not have permission to perform this action.",
"details": null
}
}{
"error": {
"code": "NOT_FOUND",
"message": "The requested resource was not found.",
"details": null
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded — retry after the delay in the `Retry-After` header.",
"details": null
}
}{
"error": {
"code": "SERVICE_UNAVAILABLE",
"message": "The service is temporarily unavailable.",
"details": null
}
}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.
curl --request GET \
--url https://api.dealroom.app/analytics/matching/investors \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.dealroom.app/analytics/matching/investors"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.dealroom.app/analytics/matching/investors', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.dealroom.app/analytics/matching/investors",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.dealroom.app/analytics/matching/investors"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.dealroom.app/analytics/matching/investors")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.dealroom.app/analytics/matching/investors")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": [
{
"investor": {
"uuid": "345d1ab6-33df-4759-9e17-0d0c0ec9ab1c",
"type": "person",
"subtype": null,
"name": "Patrick Collison",
"tagline": "<string>",
"about": "<string>",
"image": "<string>",
"dealroom_url": "<string>",
"links": {
"linkedin": "<string>",
"twitter": "<string>",
"angellist": "<string>",
"crunchbase": "<string>"
},
"locations": [
{
"role": "hq",
"city": {
"id": 123,
"name": "<string>"
},
"state": {
"id": 123,
"name": "<string>"
},
"country": {
"id": 123,
"name": "<string>"
},
"continent": {
"id": 123,
"name": "<string>"
},
"lat": 123,
"lon": 123
}
],
"roles": [
"founder"
],
"classifications": [
"startup"
],
"taxonomy": [
{
"id": 123,
"name": "<string>",
"type": "sector"
}
],
"gender": "male",
"signal_rating": 123,
"investor": {
"rank": 123,
"types": [
{
"id": 123,
"name": "<string>",
"code": "<string>"
}
],
"stages": [
{
"id": 123,
"name": "<string>",
"code": "<string>"
}
],
"deal_size": {
"min": 123,
"max": 123
},
"investments": {
"count": 123,
"total_invested": 123,
"preferred_round": "<string>",
"last_round_date": "2024-03"
},
"portfolio": {
"rounds_count": 123,
"total_valuation": 123,
"companies": {
"total": 123,
"sort": "-last_round_date",
"items": [
{
"is_lead": true,
"rounds_count": 123,
"last_round_date": "2024-03",
"company": {
"uuid": "<string>",
"type": "organization",
"subtype": "company",
"name": "<string>",
"image": "<string>",
"dealroom_url": "<string>"
}
}
]
}
},
"exits": {
"count": 123,
"total_value": 123,
"pct": 123
},
"match": {
"companies_count": 123,
"invested": 123
},
"round_match": {
"count": 123,
"total": 123,
"pct": 123
}
},
"founded_companies": {
"count": 123,
"total_funding": 123
},
"career": {
"total": 123,
"sort": "-is_founder,is_past,-start_date",
"items": [
{
"raw_title": "<string>",
"titles": [
"<string>"
],
"is_founder": true,
"is_executive": true,
"is_partner": true,
"is_past": true,
"start_date": "2024-03",
"end_date": "2024-03",
"company": {
"uuid": "<string>",
"type": "organization",
"subtype": "company",
"name": "<string>",
"image": "<string>",
"dealroom_url": "<string>"
}
}
]
},
"education": {
"total": 123,
"sort": "-start_date",
"items": [
{
"degree": {
"id": 123,
"name": "<string>"
},
"majors": [
{
"id": 123,
"name": "<string>"
}
],
"start_date": "2024-03",
"end_date": "2024-03",
"university": {
"uuid": "<string>",
"type": "organization",
"subtype": "company",
"name": "<string>",
"image": "<string>",
"dealroom_url": "<string>"
}
}
]
},
"available": [
"founded_companies"
],
"added_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
},
"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_main_hub_vc_rounds_2023_plus": 123,
"hq_main_hub_vc_rounds_2025_plus": 123,
"hq_state_vc_rounds_2023_plus": 123,
"hq_state_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_matches_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_main_hub_target_vc_rounds_2023_plus": 123,
"hq_main_hub_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
}
}
],
"currency": "EUR",
"meta": {
"total": 342,
"weights_applied": {
"geography": 123,
"sector": 123,
"stage": 123
},
"local_area": {
"type": "main_hub",
"name": "Greater Pittsburgh"
}
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "The request was malformed or failed validation.",
"details": null
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication required — provide a valid bearer token.",
"details": null
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "<string>",
"details": [
{
"path": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"code": "FORBIDDEN",
"message": "You do not have permission to perform this action.",
"details": null
}
}{
"error": {
"code": "NOT_FOUND",
"message": "The requested resource was not found.",
"details": null
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Rate limit exceeded — retry after the delay in the `Retry-After` header.",
"details": null
}
}{
"error": {
"code": "SERVICE_UNAVAILABLE",
"message": "The service is temporarily unavailable.",
"details": null
}
}Authorizations
OAuth2 client-credentials flow against the Dealroom Auth0 tenant. Use the client_id / client_secret from a Programmatic API key. Tokens are valid for 1h — Swagger UI will reuse the same token across operations. Revoking or deactivating a key rejects it on the next request (within a ≤5-minute server-side cache window), not at token expiry.
Headers
Pin a Stripe-style date-based API version (YYYY-MM-DD). Omit to use the latest version (2026-10-22). A pinned version is supported for 30 days after it is superseded, after which it returns 400.
"2026-10-22"
Query Parameters
UUID of the target company.
"345d1ab6-33df-4759-9e17-0d0c0ec9ab1c"
Round stage the company is raising.
PRE-SEED, SEED, SERIES A, SERIES B, SERIES C+ "SERIES A"
Lower bound of the target round size in USD.
"10000000"
Upper bound of the target round size in USD.
"20000000"
When true, only count rounds where the investor was a lead.
"false"
Whether the founder prefers a generalist or a sector-specialist investor. Shifts scoring weights toward geography or sector accordingly.
generalist, specialist "specialist"
Whether the founder prefers a local (same city/country) or non-local investor. Shifts scoring weights toward geography or stage accordingly.
local, non_local "local"
Number of matched investors to return (1–100, default 50).
1 <= x <= 100"50"
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).
"Netherlands"
Location granularity: continent, country, state, city, or region. Controls which HQ field is compared against filter_location_name.
"country"
Comma-separated investor type codes to include (e.g. vc,accelerator). Filters the candidate pool before ranking.
"vc"
ISO 4217 currency code for monetary field conversion. Defaults to USD.
"EUR"