---
title: "Query event metrics grouped by individual issue"
method: GET
path: "/metrics/events-by-issue"
tags: ["Metrics"]
---

# Query event metrics grouped by individual issue

`GET /metrics/events-by-issue`

Returns metrics for events broken down by individual issue IDs. Uses arrayJoin to create one row per issue per event, enabling per-issue analytics. Useful for tracking which issues affect the most events over time.

## Query parameters

- `date_range` object
  - `start` string, date-time, required — Start of the time range in ISO 8601 format
  - `end` string, date-time, required — End of the time range in ISO 8601 format
- `granularity` string, nullable — Time bucket granularity. Format: <number><unit> where unit is s (seconds 1-60), m (minutes 1-60), h (hours 1-24), d (days 1-31), w (weeks 1-4), M (months 1-12). Examples: 1s, 5m, 1h, 1d
- `filters` object
  - `issue_id` union, required — Filter by issue ID(s) - required. Single ID or array of IDs
    - string
    - string[]
  - `source_id` string — Filter by source ID
  - `destination_id` string — Filter by destination ID
  - `webhook_id` string — Filter by webhook/connection ID
- `measures` string[] — Metrics to calculate
- `dimensions` string[] — Dimensions to group by

## Response `200`

Events by issue metrics results

- MetricsResponse — Metrics query response with data and metadata
  - `data` MetricDataPoint[] — Array of metric data points
    - `time_bucket` string, nullable — Time bucket for the metric data point
    - `dimensions` object — Key-value pairs of dimension names and their values.
    - `metrics` object — Key-value pairs of metric names and their calculated values.
  - `metadata` object — Query metadata
    - `granularity` string, nullable — Time granularity used in the query
    - `query_time_ms` number, float — Query execution time in milliseconds
    - `row_count` number, float — Number of rows returned
    - `row_limit` number, float — Maximum number of rows that can be returned
    - `truncated` boolean — Whether results were truncated due to row limit
    - `warning` string — Warning message if results were truncated

---

[API](https://skmtc.dev/hookdeck/apis/hookdeck-admin-rest-api.md) · [All operations](https://skmtc.dev/hookdeck/apis/hookdeck-admin-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hookdeck/hookdeck-admin-rest-api/revisions/091808eac7fa/schema)