---
title: "List all webhook logs"
method: GET
path: "/v1/webhook-logs"
tags: ["Webhooks"]
---

# List all webhook logs

`GET /v1/webhook-logs`

## Request

- Base URL: `https://api.dotfile.com`
- URL: `https://api.dotfile.com/v1/webhook-logs`
- Auth: API key in header `X-DOTFILE-API-KEY`

Returns the webhook events delivered for your workspace — each with its full payload and every delivery attempt — filterable by case, individual, event and date. Webhook logs are retained for a limited period (30 days by default); events older than your retention period are not returned.

---

#### See also  
Learn more about [Webhook logs](./webhook-logs-guide)  
Learn more about [Filtering, Sorting and Pagination](./filtering-sorting-and-pagination)

## Query parameters

- `event` string
- `case_id` string
- `individual_id` string
- `company_id` string
- `created_at` string: Date (`yyyy-MM-dd` eg `2023-01-31`) or date time (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`) in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)
- `sort` string
- `page` number
- `limit` number

## Response `200`

List of webhook events delivered for the workspace

**ℹ️ Click to see full payload**

- WebhookLogList
  - `data` WebhookLog[], required
    - `id` string, uuid, required
    - `event` string, required: The event that triggered this delivery.
    - `status_code` number, required: HTTP status code returned on the latest delivery attempt.
    - `endpoint` string, url, required: The endpoint the event was delivered to.
    - `retry_count` number, required: Number of retries after the first delivery attempt.
    - `case_id` string, uuid, nullable, required: The case this event relates to, when applicable.
    - `individual_id` string, uuid, nullable, required: The individual this event relates to, when applicable.
    - `company_id` string, uuid, nullable, required: The company this event relates to, when applicable.
    - `webhook_id` string, uuid, required
    - `created_at` string, date-time, required: When the event was triggered. Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
    - `last_attempt_at` string, date-time, required: When the latest delivery attempt was made. Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
    - `payload` object, required: The exact JSON body delivered to your endpoint.
    - `next_retry_at` string, date-time, nullable, required: When the next automatic retry is scheduled, if any. Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
    - `attempts` WebhookLogAttempt[], required: Every delivery attempt, most recent first.
      - `type` 'first_call' | 'manual_retry' | 'automatic_retry', required: Whether this was the first call or a retry.
      - `endpoint` string, url, required: The endpoint that was called.
      - `status_code` number, required: HTTP status code returned by your endpoint.
      - `request_headers` object, required: Headers Dotfile sent, including the signature.
      - `response_headers` object, nullable, required: Headers your endpoint returned.
      - `response_body` string, nullable, required: Body your endpoint returned.
      - `attempted_at` string, date-time, required: When this attempt was made. Date time in format [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) (`yyyy-MM-ddTHH:mm:ss.S+X` eg `2023-01-31T13:30:00.000Z`)
  - `pagination` Pagination, required
    - `page` number, required: Current page number (defined in query parameter)
    - `limit` number, required: Item count per page (defined in query parameter)
    - `count` number, required: Total items count

## Other responses

- `400`: The request is either malformed or contain invalid parameters. - One or multiple filtering parameters might be malformed. Make sure to use a supported operator and value for each filter. - If specified, make sure the value of the `page` or `limit` query parameter are valid. - Value of the `sort` parameter is invalid. Make sure the field name is supported, the sorting order is correctly specified, and a same field is not used multiple times for sorting.

## Changes

- **2026-11-03** `50cab516e856`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/dotfile/apis/api-specifications/changes/v1/webhook-logs/get.md)

---

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