curl --request GET \
--url https://api.beta.dealroom.app/data/entities/geo \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.beta.dealroom.app/data/entities/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.beta.dealroom.app/data/entities/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.beta.dealroom.app/data/entities/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.beta.dealroom.app/data/entities/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.beta.dealroom.app/data/entities/geo")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.beta.dealroom.app/data/entities/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": [
{
"uuid": "<string>",
"name": "<string>",
"lat": 123,
"lon": 123,
"hq_country": "<string>",
"hq_city": "<string>"
}
],
"page": {
"total": 123,
"limit": 123,
"offset": 123,
"next_cursor": "<string>",
"prev_cursor": "<string>"
}
}{
"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 entity geo points
Lightweight endpoint designed to power map/geo visualizations, returning only id, name, lat, lon, country, and city. Supports the same filters as the entity list but with higher limits (up to 5000) and minimal payload.
curl --request GET \
--url https://api.beta.dealroom.app/data/entities/geo \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.beta.dealroom.app/data/entities/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.beta.dealroom.app/data/entities/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.beta.dealroom.app/data/entities/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.beta.dealroom.app/data/entities/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.beta.dealroom.app/data/entities/geo")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.beta.dealroom.app/data/entities/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": [
{
"uuid": "<string>",
"name": "<string>",
"lat": 123,
"lon": 123,
"hq_country": "<string>",
"hq_city": "<string>"
}
],
"page": {
"total": 123,
"limit": 123,
"offset": 123,
"next_cursor": "<string>",
"prev_cursor": "<string>"
}
}{
"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"
Query Parameters
Filter expression for geo points (same syntax as entity list).
Examples:
- Single: organization_subtype[eq]:company
- AND: and(organization_subtype[eq]:company,hq_location[eq]:233)
Operators: eq, neq, gt, gte, lt, lte, in_any, nin_any
"and(organization_subtype[eq]:company,hq_location[eq]:233)"
Number of results to return (1-5000, default 25)
1 <= x <= 500025
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"
Sort by one or more keys. Prefix with - for descending order; comma-separated for multi-key sorts.
^(?:-?\w+)?(?:,(?:-?\w+)?)*$"-launch_date"
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"