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

# Get SLO Realtime Counts

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

Get per-minute success and failure event counts for an SLO, updated approximately once per minute from a rolling 24-hour window.

This endpoint is intended for near-real-time integrations such as external SLO dashboards and alerting tools (e.g. nobl9). For weekly compliance history, use the [Get SLO History endpoint](https://api-docs.honeycomb.io/api/reporting/getSloHistory/).

**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.


**Gaps:** Some minutes may have no entry in the `windows` array. The first window after a gap may contain a larger-than-usual delta. Treat missing timestamps as unavailable data, not zero-event periods.

**Epoch:** The response includes an `epoch` field — a hash of the SLO's SLI expression and dataset configuration. If this value changes between responses, the underlying SLO definition has changed and any client-side cache should be invalidated.

**Partial windows:** Windows marked `is_partial: true` may still receive additional events. This occurs for the most recent 10 minutes (late-arriving data settlement) or when no prior snapshot exists to compute a delta from.

## Query parameters

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

## Response `200`

Success

- SLOCountsResponse
  - `slo_id` string — The unique identifier of the SLO.
  - `resolution_seconds` integer — The width of each window in seconds. Always `60`.
  - `epoch` string — A hash of the SLO's SLI expression and dataset configuration. This value changes whenever the SLO definition changes in a way that affects count computation (e.g. a derived column expression update). Clients should compare this value across responses: a change means counts have reset under a new key and any client-side cache should be invalidated.
  - `period_start` integer — Unix timestamp of the start of the current accumulation period (the most recent hour boundary). The cumulative totals used to compute deltas reset to zero at this point. Clients should re-baseline their delta computations whenever this value changes between responses.
  - `windows` SLOCountWindow[] — Ordered list of per-minute count windows within the requested time range. Gaps between windows indicate minutes with no recorded snapshot. An empty array means no data exists for the requested range.
    - `window_start` integer — Start of the window as a Unix timestamp (seconds).
    - `window_end` integer — End of the window as a Unix timestamp (seconds). Always `window_start + 60`.
    - `total_count` integer — Total number of events (good + bad) in this window.
    - `error_count` integer — Number of failed (bad) events in this window.
    - `is_partial` boolean — When `true`, the data for this window may be incomplete. This occurs in three cases: 1. **No prior anchor**: The first window has no preceding snapshot to delta from, so the value is a raw cumulative total rather than a true per-minute delta. 2. **Settlement window**: The window started within the last 10 minutes. Late-arriving events from client buffering or ingestion lag may still appear in a subsequent snapshot. 3. **Hour boundary reset**: Cumulative totals reset to zero at each hour boundary. A request spanning a boundary will see the new hour's counts start near zero while the anchor came from the prior hour's larger total. Both `total_count` and `error_count` are zeroed for this window. Use `period_start` to detect this and avoid requesting ranges that cross a boundary. Clients building alerting on top of this data should treat `is_partial: true` windows 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)