Webhooks

Count Webhook Events Per Day

Changed on

Count the team's webhook events per day over a date range (the last 30 days by default), with the credits they consumed, for one webhook or all of them. Optionally split each day by delivery status, webhook or event type, e.g. to chart delivery health over time.

get/v0/webhooks/events/count

Request

  • Base URL
    https://api.theirstack.com
  • URL
    https://api.theirstack.com/v0/webhooks/events/count
  • Auth
    HTTP bearer

Query parameters

start_datetimestring date-time nullable

Start of the range, in ISO format (e.g. 2023-01-01T00:00:00). Defaults to 30 days before the end.

end_datetimestring date-time nullable

End of the range, in ISO format (e.g. 2023-01-01T23:59:59). Defaults to now.

timezonestring

IANA timezone string (e.g., 'Europe/Madrid', 'America/New_York')

webhook_idinteger nullable

Webhook ID

group_byWebhookGroupBy[] nullable

Dimensions to split each day's count by: delivery status, webhook or event type. Several can be combined.

Response

Successful Response

period_startstring date-time required

Start of the period.

api_credits_consumedinteger

Actual ledger credits for these events, bucketed by event creation date. Includes later charges; not an estimate from event type.

number_of_eventsinteger

Number of events.

status'IN_PROGRESS' | 'SUCCESS' | 'FAILED' | 'NOT_TRIGGERED'
webhook_idinteger nullable

ID of the webhook.

event_typestring nullable

Event type of the webhook event.

number_of_executionsinteger required

Deprecated: use number_of_events.

Changes

  • 7271dd1852ceRevision changes
    • breaking

      for the query request parameter end_datetime, default value 2026-10-11T22:09:55.997002Z was removed

    • breaking

      for the query request parameter start_datetime, default value 2026-09-11T22:09:55.996996Z was removed

    • info

      query request parameter end_datetime list-of-types was widened by adding types null

    • info

      query request parameter start_datetime list-of-types was widened by adding types null

    • info

      for the query request parameter end_datetime, the type was generalized from string to no type, and format from date-time to no format

    • info

      for the query request parameter start_datetime, the type was generalized from string to no type, and format from date-time to no format

  • 6e8e8db305ceRevision changes
    • breaking

      for the query request parameter end_datetime, default value was changed from 2026-10-10T16:26:56.992660Z to 2026-10-11T22:09:55.997002Z

    • breaking

      for the query request parameter start_datetime, default value was changed from 2026-09-10T16:26:56.992652Z to 2026-09-11T22:09:55.996996Z