---
title: "List Webhook Invocations"
method: GET
path: "/api/v2/webhooks/{webhook_id}/invocations"
tags: ["Webhook Invocations"]
---

# List Webhook Invocations

`GET /api/v2/webhooks/{webhook_id}/invocations`

Returns up to 7 days of invocations for a webhook.

## Path parameters

- `webhook_id` string, required

## Query parameters

- `filter[from_ts]` string, date-time
- `filter[status]` 'unknown' | 'accepted' | 'success' | 'failed' | 'timeout' | 'circuit broken' | 'throttled' | 'client error' | 'server error'
- `filter[to_ts]` string, date-time
- `page[before]` string
- `page[after]` string
- `page[size]` integer
- `sort` 'latest_completed_at' | '-latest_completed_at'

## Response `200`

Successful response

- WebhookInvocationListResponse
  - `invocations` WebhookInvocation[]
    - `id` string — Unique invocation identifier
    - `webhook_id` string — ID of the webhook that was invoked
    - `status` 'unknown' | 'accepted' | 'success' | 'failed' | 'timeout' | 'circuit broken' | 'throttled' | 'client error' | 'server error' — Status of the webhook invocation
    - `created_at` string, date-time — When the invocation was created
    - `latest_completed_at` string, date-time — When the invocation was last completed
    - `event_type` string — Type of event that triggered the webhook
    - `attempts_count` integer — Number of delivery attempts made
  - `meta` PaginationMeta
    - `has_more` boolean — Whether there are more results available
    - `after_cursor` string — Cursor for the next page of results
    - `before_cursor` string — Cursor for the previous page of results
    - `count` integer — Total number of items (may not always be present)
  - `links` PaginationLinks
    - `prev` string, uri — URL for the previous page of results
    - `next` string, uri — URL for the next page of results

## Changes

> 29 revisions in range; 1 not diffed.

- **2025-06-12** `9eac011b0efd` — 2 breaking, 2 warning
  - for the `query` request parameter `page[size]`, default value `100` was added
  - for the `query` request parameter `page[size]`, the type/format was changed from `string`/`` to `integer`/``
  - for the `query` request parameter `page[size]`, the max was set to `100.00`
  - for the `query` request parameter `page[size]`, the min was set to `1.00`
- **2025-06-12** `e93a5ab6e2a5` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/botbrains-io/apis/support-api/changes/api/v2/webhooks/:webhook_id/invocations/get.md)

---

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