---
title: "Get Aggregated Webhook Event Count"
method: GET
path: "/v0/webhooks/events/count"
tags: ["Webhooks"]
---

# Get Aggregated Webhook Event Count

`GET /v0/webhooks/events/count`

Retrieve webhook event counts aggregated by day within a date range, with options to group by delivery status or webhook ID. Use this endpoint to build time-series charts for monitoring webhook performance and reliability.

## Query parameters

- `start_datetime` string, date-time — Start datetime in ISO format (e.g., 2023-01-01T00:00:00)
- `end_datetime` string, date-time — End datetime in ISO format (e.g., 2023-01-01T23:59:59)
- `timezone` string — IANA timezone string (e.g., 'Europe/Madrid', 'America/New_York')
- `webhook_id` integer, nullable — Webhook ID
- `group_by` WebhookGroupBy[], nullable — Dimensions to group by. Pass multiple values: ?group_by=status&group_by=event_type

## Response `200`

Successful Response

- WebhookEventCount[]
  - `period_start` string, date-time, required — Start of the period.
  - `number_of_events` integer — Number of events.
  - `status` 'IN_PROGRESS' | 'SUCCESS' | 'FAILED' | 'NOT_TRIGGERED'
  - `webhook_id` integer, nullable — ID of the webhook.
  - `event_type` string, nullable — Event type of the webhook event.
  - `number_of_executions` integer, required — Deprecated: use number_of_events.

## Other responses

- `400` — Bad Request
- `402` — Payment Required
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/theirstack/apis/theirstack-api-reference.md) · [All operations](https://skmtc.net/theirstack/apis/theirstack-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/theirstack/theirstack-api-reference/versions/2723cd54b43e/schema)