Skip to content

Get hourly metrics

GET
/v2/organizations/{organization}/projects/{project}/metrics/hourly

Returns the last hour of minute-by-minute metrics data

Authorizations

Parameters

Path Parameters

organization
required
string

Organization identifier

project
required
string

Project identifier

Query Parameters

domain
string

Filter by domain ID or domain name

metrics[]
Array<string>

Metrics to return (default: hits, bytes)

timestamp_format
string
default: iso8601
Allowed values: iso8601 unix

Timestamp format in response

Responses

200

Hourly metrics data

object
meta
required
object
period
required

The period type for this data

string
Allowed values: hourly daily monthly
hourly
granularity
required

The granularity of data points

string
Allowed values: minute day month
minute
start_time
required

Start time of the data range (ISO8601 or Unix timestamp based on timestamp_format parameter)

string
2026-01-29T12:00:00+00:00
end_time
required

End time of the data range (ISO8601 or Unix timestamp based on timestamp_format parameter)

string
2026-01-29T13:00:00+00:00
metrics
required

List of metrics included in the response

Array<string>
[
"hits",
"bytes"
]
domain

Domain filter applied (if any)

string
nullable
data
required

Metrics data keyed by metric name

object
key
additional properties
object
series
required

Time series data points

Array<object>
object
timestamp
required
One of:

ISO8601 timestamp

string format: date-time
value
required

Metric value at this timestamp

number
150
period_total
required

Total value for the period

number
8523
all_time_total
required

All-time total value

number
1284567
period_average
required

Average value per time unit in the period

number format: float
142.05
{
"hits": {
"series": [
{
"timestamp": "2026-01-29T12:00:00+00:00",
"value": 150
},
{
"timestamp": "2026-01-29T12:01:00+00:00",
"value": 142
}
],
"period_total": 8523,
"all_time_total": 1284567,
"period_average": 142.05
},
"bytes": {
"series": [
{
"timestamp": "2026-01-29T12:00:00+00:00",
"value": 1520576
},
{
"timestamp": "2026-01-29T12:01:00+00:00",
"value": 1423456
}
],
"period_total": 91234567,
"all_time_total": 12845670000,
"period_average": 1520576.12
}
}

400

Invalid metric requested

404

No domains found or domain not found