---
title: "Query attempt metrics"
method: GET
path: "/metrics/attempts"
tags: ["Metrics"]
---

# Query attempt metrics

`GET /metrics/attempts`

Query aggregated attempt metrics with time-based grouping and filtering

## 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
  - `destination_id` union — Filter by destination ID (single value or array)
    - string
    - string[]
  - `delivery_group` union — Filter by delivery group (single value or array)
    - string
    - string[]
  - `event_id` string — Filter by event ID
  - `status` union — Filter by attempt status (single value or array)
    - 'SUCCESSFUL' | 'FAILED'
    - string[]
  - `error_code` string — Filter by error code
  - `bulk_retry_id` string — Filter by bulk retry ID
  - `trigger` string — Filter by trigger type
- `measures` string[] — Metrics to calculate
- `dimensions` string[] — Dimensions to group by

## Response `200`

Attempt 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)