Skip to main content
GET
/
1
/
slos
/
{datasetSlug}
/
{sloId}
/
counts
Get SLO Realtime Counts
curl --request GET \
  --url https://api.honeycomb.io/1/slos/{datasetSlug}/{sloId}/counts
{
  "slo_id": "bZ1aRHAUsjG",
  "resolution_seconds": 60,
  "epoch": "a3f9c2d1e8b74056",
  "period_start": 1745251200,
  "windows": [
    {
      "window_start": 1745251200,
      "window_end": 1745251260,
      "total_count": 1243,
      "error_count": 3,
      "is_partial": false
    },
    {
      "window_start": 1745251260,
      "window_end": 1745251320,
      "total_count": 1188,
      "error_count": 1,
      "is_partial": false
    },
    {
      "window_start": 1745251320,
      "window_end": 1745251380,
      "total_count": 1301,
      "error_count": 0,
      "is_partial": true
    }
  ]
}

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). Must be within the last 24 hours and no later than end_time.

​
end_time
integer
required

End of the time range as a Unix timestamp (seconds). Must be greater than start_time and within the same clock hour as start_time. Realtime counts accumulate from the start of each hour and reset at hour boundaries; use the Get SLO Hourly Counts History endpoint for completed hours.

Response

Success

​
slo_id
string

The unique identifier of the SLO.

Example:

"bZ1aRHAUsjG"

​
resolution_seconds
integer

The width of each window in seconds. Always 60.

Example:

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.

Example:

"a3f9c2d1e8b74056"

​
period_start
integer<int64>

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.

Example:

1745251200

​
windows
object[]

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.