---
title: "Retrieve endpoint delivery metrics"
method: GET
path: "/v1/webhooks/endpoints/{endpoint_id}/metrics"
tags: ["Webhooks"]
---

# Retrieve endpoint delivery metrics

`GET /v1/webhooks/endpoints/{endpoint_id}/metrics`

Retrieve delivery success and failure counts for an endpoint over a time range. Requires the `webhooks:read` scope.

## Path parameters

- `endpoint_id` string, required

## Query parameters

- `period` string
- `date_from` string, date-time
- `date_to` string, date-time

## Response `200`

Delivery metrics.

- WebhookMetricsResponse — Delivery metrics for an endpoint over a time range.
  - `total` string, required — Total deliveries over the range.
  - `period` string, required — The grouping period, e.g. `day`.
  - `data` WebhookMetricsDataPoint[], required — One data point per period.
    - `date` string — The period, e.g. a date.
    - `success` integer — Successful deliveries in this period.
    - `failed` integer — Failed deliveries in this period.

---

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