List company map points
Slim company payload for map rendering (the startup map’s dot layer): one point per company with HQ coordinates and an optional size_by metric value. Accepts the same filter syntax as /companies. When size_by is set, points sort by that dimension descending, so capped responses keep the highest-value points. Companies without usable HQ coordinates are omitted. Monetary values are USD. For per-area counts (the map’s choropleth layer), use the aggregate endpoint: GET /api/analytics/aggregate/companies?metric=count&group_by=map_area.
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.
Query Parameters
Filter expression for companies — identical syntax and semantics to the /companies list filter.
"and(total_funding_usd[gte]:1000000,is_unicorn[eq]:true)"
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.
total_funding, employee_count, latest_valuation, total_invested, total_investments_count, alumni_count, alumni_founder_count "total_funding"
Number of results to return (1-5000, default 5000)
1 <= x <= 50005000
Number of results to skip before returning data. Combine with limit for offset-based pagination.
x >= 00