---
title: "List events"
method: GET
path: "/events"
---

# List events

`GET /events`

List the webhook events generated for your provider. Filter by `webhook_config`, `company`, `topic`, `status`, and a `created_after`/`created_before` (ISO-8601) time range.

## Query parameters

- `webhook_config` string
- `company` string
- `topic` string
- `status` 'pending' | 'retrying' | 'delivered' | 'failed'
- `created_after` string, date-time
- `created_before` string, date-time
- `limit` integer

## Response `200`

200

- object
  - `next` unknown
  - `previous` unknown
  - `results` object[]
    - `id` string
    - `webhook_config` string, nullable
    - `company` string
    - `topic` string
    - `body` object
    - `status` 'pending' | 'retrying' | 'delivered' | 'failed'
    - `created_at` string, date-time
    - `delivery_attempts` object[]
      - `status_code` integer, nullable
      - `created_at` string, date-time

## Other responses

- `400` — 400

---

[API](https://skmtc.net/checkhq/apis/check-api.md) · [All operations](https://skmtc.net/checkhq/apis/check-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/checkhq/check-api/revisions/f46e28134549/schema)