Skip to main content
GET
List company map points

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

API-Version
string<date>

Pin a Stripe-style date-based API version (YYYY-MM-DD). Omit to use the latest version (2026-09-01). A pinned version is supported for 30 days after it is superseded, after which it returns 400.

Example:

"2026-09-01"

Query Parameters

filter
string

Filter expression for companies — identical syntax and semantics to the /companies list filter.

Example:

"and(total_funding[gte]:1000000,is_unicorn[eq]:true)"

size_by
enum<string>

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.

Available options:
total_funding,
employee_count,
latest_valuation,
total_invested,
total_investments_count,
alumni_count,
alumni_founder_count
Example:

"total_funding"

limit
integer<int32>
default:5000

Number of results to return (1-5000, default 5000)

Required range: 1 <= x <= 5000
Example:

5000

offset
integer<int32>
default:0

Number of results to skip before returning data. Combine with limit for offset-based pagination.

Required range: x >= 0
Example:

0

Response

Company map points

data
object[]
required
page
object
required