Skip to main content
GET
Aggregate by source

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"

Path Parameters

source
enum<string>
required

The source to aggregate (founders, investors, companies, funding-rounds, valuations, entities, fundings)

Available options:
founders,
investors,
companies,
funding-rounds,
valuations,
entities,
fundings
Example:

"founders"

Query Parameters

currency
string

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

Example:

"EUR"

metric
string
required

Metric to compute: count, count_distinct:field, sum:field, avg:field, median:field, p25:field, p75:field

Minimum string length: 1
Example:

"count"

group_by
string
required

Dimension(s) to group by. Location dims: hq_country, hq_city, hq_state, hq_continent, macro_region, region. Ecosystem map areas: map_area — the startup-map choropleth dimension (counts per polygon; requires an active ecosystem, else a validation error). Pair it with the per-entity map dots at GET /data/{companies|investors|universities}/geo. Relationship fields: university.name, employer.city. Multi-dim: year,hq_country

Minimum string length: 1
Pattern: ^[a-z][a-z0-9_.]*(?:,[a-z][a-z0-9_.]*)*$
Example:

"hq_country"

filter
string

Filter expression using structured syntax: and(key[op]:value,...), or(...). Example: and(tag_id[eq]:42,hq_location[eq]:81)

Example:

"and(tag_id[eq]:42,launch_year[gte]:2020)"

sort
string

Sort by metric key or 'dimension'. Prefix with - for descending

Pattern: ^-?[a-z][a-z0-9_]*$
Example:

"-count"

limit
string

Number of results to return (1-500, default 25)

Example:

"25"

Response

Aggregated results

data
object[]
required
query_info
object
required
currency
string
required