Skip to main content
GET
/
api
/
timeseries
Timeseries — yearly metric aggregation
curl --request GET \
  --url https://api-next.dealroom.co/api/timeseries \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "year": 123,
      "value": 123
    }
  ],
  "query_info": {
    "total_years": 123,
    "timing_ms": 123
  },
  "currency": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://developers.beta.dealroom.co/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Auth0 JWT access token. Paste a token obtained from your preferred OAuth2 flow. For machine-to-machine use, the OAuth2 client_credentials scheme below can mint a token directly from your client_id / client_secret inside the Swagger UI Authorize dialog.

Query Parameters

​
metric
enum<string>
required

Metric to aggregate across years

Available options:
employees,
revenue,
valuation,
ebitda,
vc_funding
Example:

"revenue"

​
aggregation
enum<string>
default:sum

Aggregation function to apply (default: sum)

Available options:
sum,
avg,
median,
count
Example:

"sum"

​
year_min
string

Minimum year (inclusive)

Pattern: ^\d+$
Example:

"2018"

​
year_max
string

Maximum year (inclusive)

Pattern: ^\d+$
Example:

"2024"

​
filter
string

Entity filter expression: key[op]:value. Same syntax as /api/aggregate/:source

Example:

"total_funding_usd[gte]:1000000"

Response

Yearly aggregated metric values

​
data
object[]
required
​
query_info
object
required
​
currency
string