Skip to main content
GET
/
api
/
platform
/
usage
/
timeseries
Get usage timeseries
curl --request GET \
  --url https://api-next.dealroom.co/api/platform/usage/timeseries \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "bucket": "<string>",
      "endpoint": "<string>",
      "request_count": 123,
      "error_count": 123
    }
  ]
}

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.

Query Parameters

​
start_date
string<date>
required

Start date (inclusive), ISO 8601 date format

Example:

"2026-01-01"

​
end_date
string<date>
required

End date (inclusive), ISO 8601 date format

Example:

"2026-01-31"

​
client_id
string

Client ID to query (admin only — M2M tokens see own usage only)

​
granularity
enum<string>
default:daily

Time bucket granularity

Available options:
hourly,
daily
Example:

"daily"

Response

Usage timeseries

​
data
object[]
required