---
title: "List all events for a webhook subscription"
method: GET
path: "/api/v2/webhooks/subscriptions/{subscriptionId}/events"
tags: ["Subscriptions"]
---

# List all events for a webhook subscription

`GET /api/v2/webhooks/subscriptions/{subscriptionId}/events`

> 🔑
>
> Required OAuth scope: `webhooks:read`.

> 📖
>
> This endpoint is paginated with a page size of 250 webhook events. For more information, see the [Pagination guide](doc:pagination).

Lists all events for a given webhook subscription.

## Path parameters

- `subscriptionId` string, ObjectId, required

## Query parameters

- `createdAt` object
  - `lt` string, date-time — Filter on dates lower than the given one
  - `gte` string, date-time — Filter on dates greater than or equal the given one
- `status` object
  - `eq` 'delivered' | 'failed' | 'pending' | 'sending' — Filter on values equal to the given one

## Headers

- `360-api-version` 'v2.0', required

## Response `200`

Returns one page of 250 webhook events.

- EventDTO[]
  - `_id` string, required — The unique ID of the webhook event. It corresponds to the header value **webhook-id** in the webhook event request delivered to your endpoint.
  - `createdAt` string, date-time, required — The date and time when the webhook event was created, in the `YYYY-MM-DDThh:mm:ss.sssZ` format (ISO 8601 in Coordinated Universal Time (UTC)).
  - `status` 'delivered' | 'failed' | 'pending' | 'sending', required — The status of the webhook event. Options are: - `delivered`: The event was successfully delivered. - `failed`: The event failed to be delivered after all the retries. - `pending`: The event delivery process is not yet started. - `sending`: The event delivery is in progress following the retry schedule.
  - `payload` object, required — The payload sent in the webhook event.

## Other responses

- `401` — The given access token is either missing, invalid, has expired, or has been revoked.
- `403` — The given access token does not have the required OAuth scope to execute the request.
- `404` — The given `subscriptionId` does not correspond to any existing subscription.
- `429` — The client has sent too many requests in a short amount of time.

---

[API](https://skmtc.net/360learning/apis/webhook-api.md) · [All operations](https://skmtc.net/360learning/apis/webhook-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/360learning/webhook-api/versions/18374878903d/schema)