---
title: "List events for an endpoint"
method: GET
path: "/webhooks/endpoints/{endpointId}/events"
tags: ["Webhooks"]
---

# List events for an endpoint

`GET /webhooks/endpoints/{endpointId}/events`

This operation retrieves information about events that have been attempted to be published to a webhook destination endpoint. Events are queryable for a period of 30 days after creation and are returned in sets of 20 at a time. Use the pagination token to retrieve more events.

## Path parameters

- `endpointId` string, required — The id of a webhook destination endpoint

## Query parameters

- `startTime` string, date-time
- `endTime` string, date-time
- `paginationToken` string — Token given in a previous response to allow requesting the next page

## Response `200`

ok

- object
  - `events` WebhookDestinationEndpointEvent[], required
    - `data` string, required
    - `delivery` WebhookDestinationEndpointEventDelivery — Delivery information for an event that has been attempted to be sent to a webhook destination endpoint
      - `attemptLimit` integer, required — The maximum number of attempts that will be made to deliver an event
      - `attempts` integer, required — The number of attempts so far to deliver the event
      - `deliveryTime` string, date-time — The date the event was successfully delivered.
      - `nextAttemptTime` string, date-time — The date the event will attempt delivery again.
      - `status` string, required
    - `eventTime` string, date-time, required — The date the event was created
    - `id` string, required — The id of an event
    - `object` string, required — String representing the object's type
  - `hasMore` boolean, required
  - `paginationToken` string — Token given in a previous response to allow requesting the next page

## Other responses

- `400` — bad request
- `404` — not found
- `500` — unexpected error

---

[API](https://skmtc.net/sprucehealth/apis/spruce-health-api.md) · [All operations](https://skmtc.net/sprucehealth/apis/spruce-health-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sprucehealth/spruce-health-api/revisions/988e298cd9fd/schema)