IntroductionQuickstartAuthenticationPaginationRate Limit

Search endpoints

Job Search POSTCompany Search POSTTechnographics POST

Account endpoints

Get Credit Balance GETGet Credits Consumption GET

Other

Get Webhook By Id GETGet Aggregated Webhook Event Count GETGet Webhook Event Count GETList Webhook Events GETList All Webhooks GETArchive Webhook PATCHUpdate Webhook PATCHEnable/Disable A Webhook PATCHRetry Webhook Events POSTTest Webhook Url POSTCreate New Webhook POST
TheirStackTheirStack Logo
Log inSign up
DocumentationAPI ReferenceWebhooksDatasetsMCPGuides
Webhooks

Get Aggregated Webhook Event 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.

GET
/v0/webhooks/events/count

Authorization

Bearer
AuthorizationBearer <token>

In: header

Query Parameters

  • start_datetime
    string
    date-timedefault: "2026-02-03T17:56:29.567391Z"

    Start datetime in ISO format (e.g., 2023-01-01T00:00:00)

  • end_datetime
    string
    date-timedefault: "2026-03-05T17:56:29.567433Z"

    End datetime in ISO format (e.g., 2023-01-01T23:59:59)

  • timezone
    string
    default: "UTC"

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

  • webhook_id
    integernullable

    Webhook ID

  • group_by
    string
    default: "status"

    How to group the results: by status or webhook_id

    • status
    • webhook_id
  • Response Body

    application/json

    application/json

    application/json

    application/json

    application/json

    curl -X GET "https://api.theirstack.com/v0/webhooks/events/count"
    [
      {
        "period_start": "2019-08-24T14:15:22Z",
        "number_of_events": 0,
        "status": "IN_PROGRESS",
        "webhook_id": 0,
        "number_of_executions": 0
      }
    ]
    {
      "request_id": null,
      "error": {
        "code": "E-001",
        "title": "Not allowed exception",
        "description": "string"
      }
    }
    {
      "request_id": null,
      "error": {
        "code": "E-001",
        "title": "Not allowed exception",
        "description": "string"
      }
    }
    {
      "request_id": null,
      "error": {
        "code": "E-001",
        "title": "Not allowed exception",
        "description": "string"
      }
    }
    {
      "request_id": null,
      "error": {
        "code": "E-001",
        "title": "Not allowed exception",
        "description": "string"
      }
    }

    How is this guide?

    Last updated on

    Get Webhook By Id GET

    Retrieve the full details of a specific webhook by its ID including configuration, status, target URL, event type, linked saved search, and creation timestamp. Use this to inspect or debug a webhook setup.

    Get Webhook Event Count GET

    Get the total count of events triggered for a specific webhook. Use this endpoint to quickly check webhook activity volume without fetching the full event list, useful for monitoring dashboards and usage tracking.