curl --request GET \
--url https://api.dealroom.app/data/investors/geo \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.dealroom.app/data/investors/geo"
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/data/investors/geo', 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/data/investors/geo",
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/data/investors/geo"
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/data/investors/geo")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.dealroom.app/data/investors/geo")
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": [
{
"id": "b4e2c9a1-7f3d-4e8b-9c2a-1d5f6e8a3b7c",
"name": "<string>",
"lat": 123,
"lon": 123,
"logo": "<string>",
"value": 123
}
],
"page": {
"total": 123,
"limit": 123,
"offset": 123,
"next_cursor": "<string>",
"prev_cursor": "<string>"
},
"locked": [
{
"field": "<string>",
"reason": "ACCOUNT_REQUIRED",
"unlock": "signup"
}
]
}{
"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 investor map points
Slim investor payload for map rendering (the startup map’s dot layer): one point per investor with HQ coordinates and an optional size_by metric value. Accepts the same filter syntax as /investors. When size_by is set, points sort by that dimension descending, so a bounded page keeps the highest-value points; continue with cursor from page.next_cursor. Investors without usable HQ coordinates are omitted. Monetary values are USD. For per-area counts (the map’s choropleth layer), use the aggregate endpoint: GET /analytics/aggregate/investors?metric=count&group_by=map_area.
curl --request GET \
--url https://api.dealroom.app/data/investors/geo \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.dealroom.app/data/investors/geo"
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/data/investors/geo', 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/data/investors/geo",
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/data/investors/geo"
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/data/investors/geo")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.dealroom.app/data/investors/geo")
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": [
{
"id": "b4e2c9a1-7f3d-4e8b-9c2a-1d5f6e8a3b7c",
"name": "<string>",
"lat": 123,
"lon": 123,
"logo": "<string>",
"value": 123
}
],
"page": {
"total": 123,
"limit": 123,
"offset": 123,
"next_cursor": "<string>",
"prev_cursor": "<string>"
},
"locked": [
{
"field": "<string>",
"reason": "ACCOUNT_REQUIRED",
"unlock": "signup"
}
]
}{
"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 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
Query Parameters
Numeric dimension returned as each point's value (for proportional dot sizing). Monetary dimensions are USD. Also sorts the result descending, so a capped response keeps the highest-value points. Omitted → value is null and the default sort applies. employees_count requires an account and latest_valuation / total_invested require premium: below that tier value is null, the default sort applies and locked[] names value.
total_funding, employees_count, latest_valuation, total_invested, investments_count, alumni_count, alumni_founders_count "total_funding"