Skip to main content
GET
Match investors

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

Scopes

read:investors
oauth2

Grant the read:investors permission

read:investors
bearerAuth

Headers

API-Version
string<date>

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.

Example:

"2026-10-22"

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"

currency
string

ISO 4217 currency code for monetary field conversion. Defaults to USD.

Example:

"EUR"

Response

Ranked list of matched investors with scoring breakdown

data
object[]
required
currency
string
required

Currency the investor monetary fields are expressed in (default USD).

Example:

"EUR"

meta
object
required