---
title: "Get Event Metrics"
method: GET
path: "/metrics/events"
tags: ["Metrics"]
---

# Get Event Metrics

`GET /metrics/events`

Returns aggregated event publish metrics. Supports time bucketing via granularity,
dimensional grouping, and filtering.

**Measures:** `count`, `rate`

**Dimensions:** `tenant_id` (admin-only), `topic`, `destination_id`

**Filters:** `tenant_id` (admin-only), `topic`, `destination_id`

## Query parameters

- `time` object, required
  - `start` string, date-time, required — Start of the time range (inclusive). ISO 8601 timestamp.
  - `end` string, date-time, required — End of the time range (exclusive). ISO 8601 timestamp.
- `granularity` string
- `measures` union, required
  - 'count' | 'rate'
  - string[]
- `dimensions` union
  - 'tenant_id' | 'topic' | 'destination_id'
  - string[]
- `filters[topic]` union
  - string
  - string[]
- `filters[destination_id]` union
  - string
  - string[]
- `filters[tenant_id]` union
  - string
  - string[]

## Response `200`

Aggregated event metrics.

- MetricsResponse
  - `data` MetricsDataPoint[] — Array of aggregated data points.
    - `time_bucket` string, date-time — Start of the time bucket. Absent when no granularity is specified.
    - `dimensions` object — Dimension values for this data point. Empty object when no dimensions are requested.
    - `metrics` object — Requested measure values for this data point.
  - `metadata` MetricsMetadata
    - `granularity` string — The granularity used for time bucketing. Absent when none was specified.
    - `query_time_ms` integer — Query execution time in milliseconds.
    - `row_count` integer — Number of data points returned.
    - `row_limit` integer — Maximum number of rows the query will return.
    - `truncated` boolean — Whether the results were truncated due to hitting the row limit.

## Other responses

- `400` — Malformed JSON or invalid request parameters.
- `401` — Missing or invalid authentication credentials.
- `403` — JWT caller attempted to use admin-only dimension or filter (tenant_id).
- `500` — Unexpected server error.

---

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