---
title: "Query webhook logs"
method: GET
path: "/webhooks/{webhookId}/logs"
tags: ["Webhook Logs"]
---

# Query webhook logs

`GET /webhooks/{webhookId}/logs`

## Request

- Base URL: `https://api.pax8.com/api/v2`
- URL: `https://api.pax8.com/api/v2/webhooks/{webhookId}/logs`
- Auth: none declared

Lists instances of WebhookLogView with the ability to query against fields in WebhookLogView.

## Path parameters

- `webhookId` string, uuid, required

## Query parameters

- `topicName` string
- `page` integer
- `size` integer
- `status` string
- `startDate` string
- `endDate` string
- `sort` string
- `query` object, required

## Response `200`

The request has succeeded.

- WebhookLogPagedResult: Paged response for webhook logs
  - `content` WebhookLog[], required: List of webhook logs
    - `id` string, uuid, required: Unique identifier for the log entry
    - `webhookId` string, uuid, required: ID of the webhook this log belongs to
    - `webhookName` string, required: Display name of the webhook
    - `finalStatus` 'PENDING' | 'SUCCESS' | 'FAILED' | 'RETRYING', required: Status of webhook delivery
    - `callHistory` WebhookCall[], required: History of delivery attempts
      - `id` string, uuid, required: Unique identifier for the call attempt
      - `timestamp` string, date-time, required: Timestamp of the call attempt
      - `status` 'PENDING' | 'SUCCESS' | 'FAILED' | 'RETRYING', required: Status of webhook delivery
      - `errorMessage` string: Error message if the call failed
      - `httpStatusCode` integer: HTTP status code returned by the webhook endpoint
      - `payload` object: The payload that was sent in the webhook
    - `createdAt` string, date-time, required: Timestamp when the log was created
  - `page` Page, required
    - `number` integer, required
    - `size` integer, required
    - `totalElements` integer, required
    - `totalPages` integer, required

## Other responses

- `400`: The request is missing required parameters or has invalid parameters
- `401`: Missing or invalid token
- `403`: User does not have permission to access this resource
- `500`: Server error

---

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