Get SLO Hourly Counts History

Get hourly-bucketed total and error event counts for an SLO from the persistent historical store. Use this endpoint to retrieve completed historical hours; pair with the Get SLO Realtime Counts endpoint for the current in-progress hour.

Requirements:

• Available on the Enterprise plan only.
• This feature must be enabled for your team. Contact your account team to request access.

Partial buckets: The most recent bucket may be marked is_partial: true if it covers the current in-progress hour. Counts for that bucket will increase until the hour completes.

GET /1/slos/{datasetSlug}/{sloId}/counts/history

Get SLO Hourly Counts History

cURL

curl --request GET \
  --url https://api.honeycomb.io/1/slos/{datasetSlug}/{sloId}/counts/history \
  --header 'X-Honeycomb-Team: <api-key>'

200

{
  "slo_id": "bZ1aRHAUsjG",
  "resolution_seconds": 3600,
  "buckets": [
    {
      "start_time": 1745168400,
      "end_time": 1745172000,
      "total_count": 74520,
      "error_count": 182,
      "is_partial": false
    },
    {
      "start_time": 1745172000,
      "end_time": 1745175600,
      "total_count": 71043,
      "error_count": 97,
      "is_partial": false
    },
    {
      "start_time": 1745251200,
      "end_time": 1745254800,
      "total_count": 12300,
      "error_count": 14,
      "is_partial": true
    }
  ]
}

Authorizations

X-Honeycomb-Team · string · header · required

A Honeycomb Configuration Key is required to use this API. A Configuration Key can be found in the API Keys section of the environment configuration, which can be found under Environment Settings -> API Keys -> Configuration tab. Check out our documentation to find your API Keys.

More information can be found in Manage Environments.

Path Parameters

datasetSlug · string · required

The dataset slug or use __all__ for endpoints that support environment-wide operations.

sloId · string · required

Unique identifier (ID) of the SLO.

Query Parameters

start_time · integer · required

Start of the time range as a Unix timestamp (seconds).

end_time · integer · required

End of the time range as a Unix timestamp (seconds). Must be greater than start_time.

Response

200

application/json

Success

slo_id · string

The unique identifier of the SLO.

Example:

"bZ1aRHAUsjG"

resolution_seconds · integer

The width of each bucket in seconds. Always 3600.

Example:

3600

buckets · object[]

Ordered list of hourly count buckets within the requested time range. Gaps indicate hours with no recorded data. An empty array means no data exists for the requested range.

Show child attributes