---
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 Content
- `500` — Internal Server Error

## Changes

- **2026-09-02** `47a26a9dd3ec` — 2 breaking
  - for the `query` request parameter `end_datetime`, default value was changed from `2026-09-01T15:32:20.867084Z` to `2026-09-02T16:09:03.556677Z`
  - for the `query` request parameter `start_datetime`, default value was changed from `2026-08-02T15:32:20.867077Z` to `2026-08-03T16:09:03.556665Z`
- **2026-09-01** `499dca900595` — 2 breaking
  - for the `query` request parameter `end_datetime`, default value was changed from `2026-08-31T19:40:20.794609Z` to `2026-09-01T15:32:20.867084Z`
  - for the `query` request parameter `start_datetime`, default value was changed from `2026-08-01T19:40:20.794601Z` to `2026-08-02T15:32:20.867077Z`
- **2026-09-01** `73eb8fd52e56` — 2 breaking
  - for the `query` request parameter `end_datetime`, default value was changed from `2026-08-29T18:42:49.283722Z` to `2026-08-31T19:40:20.794609Z`
  - for the `query` request parameter `start_datetime`, default value was changed from `2026-07-30T18:42:49.283715Z` to `2026-08-01T19:40:20.794601Z`
- **2026-08-30** `3a2b17eb0748` — 2 breaking
  - for the `query` request parameter `end_datetime`, default value was changed from `2026-08-29T14:23:19.201060Z` to `2026-08-29T18:42:49.283722Z`
  - for the `query` request parameter `start_datetime`, default value was changed from `2026-07-30T14:23:19.201052Z` to `2026-07-30T18:42:49.283715Z`
- …earlier changes not shown

[Full history](https://skmtc.dev/theirstack/apis/theirstack-api-reference/changes/v0/webhooks/events/count/get.md)

---

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