curl --request GET \
--url https://api.beta.dealroom.app/data/companies/{id}/investors \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.beta.dealroom.app/data/companies/{id}/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.beta.dealroom.app/data/companies/{id}/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.beta.dealroom.app/data/companies/{id}/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.beta.dealroom.app/data/companies/{id}/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.beta.dealroom.app/data/companies/{id}/investors")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.beta.dealroom.app/data/companies/{id}/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": [
{
"is_lead": true,
"rounds_count": 123,
"last_round_date": "2024-03",
"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": {
"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"
}
},
"added_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
}
],
"page": {
"total": 123,
"limit": 123,
"offset": 123,
"next_cursor": "<string>",
"prev_cursor": "<string>"
},
"currency": "EUR"
}{
"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": "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
}
}List investors
Investors that invested in the company, de-duplicated to one row per investor with their aggregate involvement. Includes investors not attributed to any disclosed round (rounds_count: 0); pass ?scope=additional to fetch only those (they sort last, so large round-investor lists otherwise push them past the page limit). Supports the same entity ?filter[...] DSL as /data/investors.
curl --request GET \
--url https://api.beta.dealroom.app/data/companies/{id}/investors \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.beta.dealroom.app/data/companies/{id}/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.beta.dealroom.app/data/companies/{id}/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.beta.dealroom.app/data/companies/{id}/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.beta.dealroom.app/data/companies/{id}/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.beta.dealroom.app/data/companies/{id}/investors")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.beta.dealroom.app/data/companies/{id}/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": [
{
"is_lead": true,
"rounds_count": 123,
"last_round_date": "2024-03",
"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": {
"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"
}
},
"added_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z"
}
}
],
"page": {
"total": 123,
"limit": 123,
"offset": 123,
"next_cursor": "<string>",
"prev_cursor": "<string>"
},
"currency": "EUR"
}{
"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": "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 24h — 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-09). A pinned version is supported for 30 days after it is superseded, after which it returns 400.
"2026-10-09"
Path Parameters
Stable UUID of the entity. Numeric ids are not accepted.
1"345d1ab6-33df-4759-9e17-0d0c0ec9ab1c"
Query Parameters
Filter expression for the investors — same syntax and keys as /data/investors.
Operators: eq, neq, gt, gte, lt, lte, in_any, nin_any Default ref: 'entity'
"investor_type[eq]:venture_capital"
Number of results to return (1-500, default 25)
1 <= x <= 50025
Opaque cursor token from a previous response's page.next_cursor or page.prev_cursor. Round-trip it as-is — do not decode or modify.
"eyJ2IjoxLCJkIjoibmV4dCJ9"
Pass true to compute page.total (the matching record count). By default no count query runs and page.total is null.
true
ISO 4217 currency code for monetary field conversion. Defaults to USD.
"EUR"
Which investors to return. all (default) returns every investor; rounds returns only round participants (rounds_count > 0); additional returns only investors not attributed to any disclosed round (rounds_count: 0). Use additional to fetch the profile strip without paginating past a large round-investor list.
all, rounds, additional "additional"