Skip to content

Get table usage time series

GET
/dataset-tables/{tableId}/usage/timeseries

Returns aggregated usage metrics (queries, ingests, cache hit rate) for a table over time.

tableId
required

Unique identifier of the table to retrieve

string

Unique identifier of the table to retrieve

startDate

Start of the date range (ISO 8601)

string format: date-time

Start of the date range (ISO 8601)

endDate

End of the date range (ISO 8601)

string format: date-time

End of the date range (ISO 8601)

granularity

Time bucket granularity for the data points

string
default: day
Allowed values: hour day week

Time bucket granularity for the data points

Table usage time series retrieved successfully

object
tableId
required

ID of the table

string
granularity
required

Time granularity of the data points

string
Allowed values: hour day week
points
required

Array of usage data points

Array<object>
object
date
required

Start of the time bucket (ISO 8601)

string format: date-time
totalOperations
required

Total operations in this time bucket

number
totalQueries
required

Query operations in this time bucket

number
totalIngests
required

Ingestion operations in this time bucket

number
totalOther
required

Other operations (maintenance, etc.) in this time bucket

number
cacheHitRate
required

Cache hit rate for this time bucket (0.0-1.0)

number

Bad Request - Validation error or invalid input

object
error
required
string
code
string
details
nullable
retryable
boolean

Unauthorized - Authentication required or invalid token

object
error
required
string
code
string
details
nullable
retryable
boolean

Forbidden - Insufficient permissions

object
error
required
string
code
string
details
nullable
retryable
boolean

Not Found - Resource does not exist

object
error
required
string
code
string
details
nullable
retryable
boolean