---
title: "Get SLO Hourly Counts History"
method: GET
path: "/1/slos/{datasetSlug}/{sloId}/counts/history"
tags: ["SLOs"]
---

# Get SLO Hourly Counts History

`GET /1/slos/{datasetSlug}/{sloId}/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](https://api-docs.honeycomb.io/api/slos/getslorealtimecounts/) for the current in-progress hour.

**Requirements:**
- Available on the [Enterprise plan](https://www.honeycomb.io/pricing/) 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.

## Query parameters

- `start_time` integer, required
- `end_time` integer, required

## Response `200`

Success

- SLOHourlyCountsResponse
  - `slo_id` string — The unique identifier of the SLO.
  - `resolution_seconds` integer — The width of each bucket in seconds. Always `3600`.
  - `buckets` SLOHourBucket[] — 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.
    - `start_time` integer — Start of the hour as a Unix timestamp (seconds).
    - `end_time` integer — End of the hour as a Unix timestamp (seconds). Always `start_time + 3600`.
    - `total_count` integer — Total number of events (good + bad) in this hour.
    - `error_count` integer — Number of failed (bad) events in this hour.
    - `is_partial` boolean — When `true`, this bucket covers the current in-progress hour and its counts will increase until the hour completes. Clients should treat `is_partial: true` buckets as provisional.

## Other responses

- `400` — The provided request body was invalid.
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Rate Limit Exceeded
- `default` — Error

---

[API](https://skmtc.net/honeycomb/apis/honeycomb-api.md) · [All operations](https://skmtc.net/honeycomb/apis/honeycomb-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/honeycomb/honeycomb-api/revisions/117619fac2a5/schema)