---
title: "List webhook events"
method: GET
path: "/webhook-events"
tags: ["webhooks"]
---

# List webhook events

`GET /webhook-events`

## Query parameters

- `ids` string[]
- `q` string
- `webhook_id` string
- `limit` integer — Page limit (default 100)
- `offset` integer — Page offset (default 0)

## Response `200`

OK

- object
  - `data` WebhookEventDetailResponseData[], required
    - `created_at` string, date-time, required
    - `id` string, required
    - `payload` string, nullable
    - `request_type` 'subscription.trial.ended' | 'company.created' | 'company.deleted' | 'company.override.created' | 'company.override.deleted' | 'company.override.expired' | 'company.override.updated' | 'company.plan_changed' | 'company.scheduled_downgrade' | 'company.updated' | 'credit.limit.reached' | 'credit.limit.warning' | 'credit.purchase.success' | 'entitlement.limit.reached' | 'entitlement.limit.warning' | 'entitlement.soft_limit.reached' | 'entitlement.soft_limit.warning' | 'entitlement.tier_limit.reached' | 'entitlement.tier_limit.warning' | 'feature.created' | 'feature.deleted' | 'feature.updated' | 'flag.created' | 'flag.deleted' | 'flag_rules.updated' | 'flag.updated' | 'plan.created' | 'plan.deleted' | 'plan.entitlement.created' | 'plan.entitlement.deleted' | 'plan.entitlement.updated' | 'plan.updated' | 'plan_version.deleted' | 'rule.deleted' | 'test.send' | 'user.created' | 'user.deleted' | 'user.updated' | 'auto.topup.hard.failure' | 'auto.topup.retry.exceeded' | 'auto.topup.success', required
    - `response_code` integer, nullable
    - `sent_at` string, date-time, nullable
    - `status` 'failure' | 'pending' | 'success', required
    - `updated_at` string, date-time, required
    - `webhook` WebhookResponseData
      - `created_at` string, date-time, required
      - `credit_trigger_configs` CreditTriggerConfig[], nullable
        - `credit_id` string, required
      - `entitlement_trigger_configs` EntitlementTriggerConfig[], nullable
        - `feature_id` string, required
      - `id` string, required
      - `name` string, required
      - `request_types` WebhookRequestType[], required
      - `secret` string, required
      - `status` 'active' | 'inactive', required
      - `updated_at` string, date-time, required
      - `url` string, required
    - `webhook_id` string, required
  - `params` object, required — Input parameters
    - `ids` string[]
    - `limit` integer — Page limit (default 100)
    - `offset` integer — Page offset (default 0)
    - `q` string
    - `webhook_id` string

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Server error

## Changes

- **2026-07-22** `2a86c9635dd0` — 4 warning
  - added the new `auto.topup.success` enum value to the `data/items/request_type` response property for the response status `200`
  - added the new `auto.topup.success` enum value to the `data/items/webhook/request_types/items/` response property for the response status `200`
  - added the new `credit.purchase.success` enum value to the `data/items/request_type` response property for the response status `200`
  - added the new `credit.purchase.success` enum value to the `data/items/webhook/request_types/items/` response property for the response status `200`
- **2026-07-15** `3baa54bf8b3f` — 2 warning
  - for the `query` request parameter `limit`, the max was set to `250.00`
  - for the `query` request parameter `limit`, the min was set to `0.00`

[Change history](https://skmtc.dev/schematichq/apis/schematic-api/changes/webhook-events/get.md)

---

[API](https://skmtc.dev/schematichq/apis/schematic-api.md) · [All operations](https://skmtc.dev/schematichq/apis/schematic-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/schematichq/schematic-api/revisions/0b238e148fa1/schema)