Skip to content

Get monthly metrics

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

Returns the last 12 months of monthly 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

Monthly 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