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

# List Webhook Messages

`GET /v1/webhooks/messages`

## Request

- Base URL: `https://api.sandbox.usenash.com`
- URL: `https://api.sandbox.usenash.com/v1/webhooks/messages`
- Auth: none declared

Inspect webhooks sent to this organization's configured endpoints via Svix. Primarily intended for debugging 'did the customer receive our webhook?' questions. Every outbound webhook is tagged with the relevant entity IDs (e.g. `jb_abc123`, `dlv_xyz789`), so pass the Nash ID as `tag` to find all webhooks about that entity. Returns an empty result if the organization has no Svix app configured.

## Query parameters

- `tag` string, nullable: Filter messages by tag. Nash stamps entity IDs as tags on every outbound webhook, so pass the prefixed Nash ID directly — e.g. `jb_abc123` to find every webhook about a job, `dlv_xyz789` for a delivery.
- `eventTypes` string, nullable: Comma-separated Svix event types (e.g. delivery.status_updated)
- `channel` string, nullable: Filter by Svix channel
- `before` string, date-time, nullable: Return messages sent before this timestamp
- `after` string, date-time, nullable: Return messages sent after this timestamp
- `limit` integer
- `iterator` string, nullable: Svix pagination cursor — pass the `iterator` from a previous response to fetch the next page
- `withContent` boolean: Include the message payload in the response. Defaults to true for debugging.

## Response `200`

OK

- WebhookMessagesListResponse
  - `results` WebhookMessage[], required
    - `id` string, required
    - `eventId` string, nullable
    - `eventType` string, required
    - `timestamp` string, date-time, required
    - `channels` string[], nullable
    - `tags` string[], nullable
    - `payload` object, nullable
  - `iterator` string, nullable: Cursor to pass back in the next request to fetch older messages. Null when `done` is true.
  - `prevIterator` string, nullable
  - `done` boolean, required

## Other responses

- `422`: Unprocessable Content

---

[API](https://skmtc.dev/nash/apis/nash-api.md) - [All operations](https://skmtc.dev/nash/apis/nash-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nash/apis/nash-api/revisions/e3713837c5c9?raw)