---
title: "List webhook logs"
method: GET
path: "/webhooks/{webhookId}/logs"
tags: ["Webhooks"]
---

# List webhook logs

`GET /webhooks/{webhookId}/logs`

Retrieve a list of delivery logs for a webhook by providing its unique
identifier. This is useful for analysis and debugging purposes. The
returned list is [paginated](#pagination) and can be scrolled by
following the `next` and `prev` links where present. Results are ordered
newest first to oldest last. Logs may be automatically purged after a
period of time.

## Path parameters

- `webhookId` string, required

## Query parameters

- `page[size]` integer

## Response `200`

Successful response

- ListWebhookDeliveryLogsResponse — Successful response to get all delivery logs for a webhook. This returns a paginated list of delivery logs, which can be scrolled by following the `next` and `prev` links if present.
  - `data` WebhookDeliveryLogResource[], required — The list of delivery logs returned in this response.
    - `type` string, required — The type of this resource: `webhook-delivery-logs`
    - `id` string, required — The unique identifier for this log entry.
    - `attributes` object, required
      - `request` object, required — Information about the request that was sent to the webhook URL.
        - `body` string, required — The payload that was sent in the request body.
      - `response` object, nullable, required — Information about the response that was received from the webhook URL.
        - `statusCode` integer, required — The HTTP status code received in the response.
        - `body` string, required — The payload that was received in the response body.
      - `deliveryStatus` 'DELIVERED' | 'UNDELIVERABLE' | 'BAD_RESPONSE_CODE', required — Specifies the nature of the success or failure of a webhook delivery attempt to the subscribed webhook URL. The currently returned values are described below: - **`DELIVERED`**: The event was delivered to the webhook URL successfully and a `200` response was received. - **`UNDELIVERABLE`**: The webhook URL was not reachable, or timed out. - **`BAD_RESPONSE_CODE`**: The event was delivered to the webhook URL but a non-`200` response was received.
      - `createdAt` string, date-time, required — The date-time at which this log entry was created.
    - `relationships` object, required
      - `webhookEvent` object, required
        - `data` object, required
          - `type` string, required — The type of this resource: `webhook-events`
          - `id` string, required — The unique identifier of the resource within its type.
  - `links` object, required
    - `prev` string, nullable, required — The link to the previous page in the results. If this value is `null` there is no previous page.
    - `next` string, nullable, required — The link to the next page in the results. If this value is `null` there is no next page.

## Changes

- **2020-08-15** (v1) `f3c8cf9cc9e6` — 1 warning
  - removed the optional property `data/items/links` from the response with the `200` status
- **2020-07-21** (v1) `2ac77a5de971` — 1 info
  - added the optional property `data/items/links` to the response with the `200` status

[Change history](https://skmtc.dev/up-banking/apis/up-api/changes/webhooks/:webhookId/logs/get.md)

---

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