---
title: "Query request metrics"
method: GET
path: "/metrics/requests"
tags: ["Metrics"]
---

# Query request metrics

`GET /metrics/requests`

Query aggregated request 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
  - `source_id` union — Filter by source ID (single value or array)
    - string
    - string[]
  - `rejection_cause` union — Filter by rejection cause (single value or array)
    - 'SOURCE_DISABLED' | 'NO_CONNECTION' | 'VERIFICATION_FAILED' | 'UNSUPPORTED_HTTP_METHOD' | 'UNSUPPORTED_CONTENT_TYPE' | 'UNPARSABLE_JSON' | 'PAYLOAD_TOO_LARGE' | 'INGESTION_FATAL' | 'UNKNOWN'
    - string[]
  - `status` union — Filter by request status (single value or array)
    - 'ACCEPTED' | 'REJECTED'
    - string[]
  - `bulk_retry_ids` string[] — Filter by bulk retry operation IDs
  - `events_count` object — Filter by number of events created (range with min/max)
    - `min` integer — Minimum number of events
    - `max` integer — Maximum number of events
  - `ignored_count` object — Filter by number of ignored connections (range with min/max)
    - `min` integer — Minimum number of ignored
    - `max` integer — Maximum number of ignored
- `measures` string[] — Metrics to calculate
- `dimensions` string[] — Dimensions to group by

## Response `200`

Request 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.net/hookdeck/apis/hookdeck-admin-rest-api.md) · [All operations](https://skmtc.net/hookdeck/apis/hookdeck-admin-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hookdeck/hookdeck-admin-rest-api/versions/31da4ed27d31/schema)