---
title: "List webhook messages"
method: GET
path: "/v1/webhooks/messages"
tags: ["Webhooks"]
---

# List webhook messages

`GET /v1/webhooks/messages`

Returns webhook messages sent to the organization, newest first. Scope to an endpoint with endpointId for per-endpoint delivery status and status filtering. Paginate with the iterator cursor returned by the previous page. Message history is retained for 90 days.

## Query parameters

- `endpointId` string
- `eventTypes` string[]
- `status` 'SUCCESS' | 'PENDING' | 'FAIL' | 'SENDING' | 'CANCELED'
- `before` string
- `after` string
- `tag` string
- `iterator` string
- `limit` number

## Headers

- `X-API-Key` string

## Response `200`

Webhook messages retrieved successfully

- WebhookMessageListResponseDto
  - `available` boolean, required — Whether delivery history is available for this organization. False when the organization uses a custom delivery integration.
  - `data` WebhookMessageSummaryDto[], required
    - `id` string, required
    - `eventType` string, required
    - `timestamp` string, date-time, required
    - `tags` string[] — Resource IDs carried on the message
    - `status` 'SUCCESS' | 'PENDING' | 'FAIL' | 'SENDING' | 'CANCELED' — Delivery status to the endpoint. Only present when the list is scoped to an endpoint.
    - `nextAttempt` string, date-time, nullable — Next scheduled retry, when delivery is still pending
  - `iterator` string, nullable, required — Cursor for the next page, when more results exist
  - `done` boolean, required — Whether this is the last page

## Other responses

- `401` — Unauthorized - Invalid or missing authentication credentials

---

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