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

# List event logs

`GET /webhook/logs`

List event logs

## Query parameters

- `cursor` string, nullable
- `limit` integer
- `filter` WebhookEventLogsFilter
  - `exclude_apis` string, nullable
  - `service` object, nullable
    - `id` string
  - `consumer_id` string, nullable
  - `entity_type` string, nullable
  - `event_type` string, nullable
  - `start_date` string, date-time, nullable — Filter logs at or after this ISO 8601 date-time (inclusive).
  - `end_date` string, date-time, nullable — Filter logs at or before this ISO 8601 date-time (inclusive). Must be on or after start_date.
  - `success` boolean, nullable — Filter by delivery success or failure.
  - `status_code` number, nullable — Filter by a single HTTP status code. For backward compatibility - use status_codes for multiple values.
  - `status_codes` number[], nullable — Filter by multiple HTTP status codes. Values must be between 100-599. Maximum 50 status codes allowed.
  - `event_id` string, nullable — Filter by webhook event ID.
  - `execution_attempt` number, nullable — Filter by the delivery attempt number.

## Headers

- `x-apideck-app-id` string, required

## Response `200`

EventLogs

- GetWebhookEventLogsResponse
  - `status_code` integer, required — HTTP Response Status Code
  - `status` string, required — HTTP Response Status
  - `data` WebhookEventLog[], required
    - `id` string
    - `status_code` integer — HTTP Status code that was returned.
    - `success` boolean — Whether or not the request was successful.
    - `application_id` string — ID of your Apideck Application
    - `consumer_id` string — Unique consumer identifier. You can freely choose a consumer ID yourself. Most of the time, this is an ID of your internal data model that represents a user or account in your system (for example account:12345). If the consumer doesn't exist yet, Vault will upsert a consumer based on your ID.
    - `unified_api` 'accounting' | 'ats' | 'calendar' | 'crm' | 'csp' | 'customer-support' | 'ecommerce' | 'email' | 'email-marketing' | 'expense-management' | 'file-storage' | 'form' | 'hris' | 'lead' | 'payroll' | 'pos' | 'procurement' | 'project-management' | 'script' | 'sms' | 'spreadsheet' | 'subscription-analytics' | 'team-messaging' | 'issue-tracking' | 'time-registration' | 'transactional-email' | 'vault' | 'data-warehouse' — Name of Apideck Unified API
    - `service` object — Apideck service provider associated with event.
      - `id` string, required — Apideck service provider id.
      - `name` string, required — Apideck service provider name.
    - `endpoint` string, uri — The URL of the webhook endpoint.
    - `event_type` string — Name of source event that webhook is subscribed to.
    - `execution_attempt` number — Number of attempts webhook endpoint was called before a success was returned or eventually failed
    - `http_method` string — HTTP Method of request to endpoint.
    - `timestamp` string — ISO Date and time when the request was made.
    - `entity_type` string — Name of the Entity described by the attributes delivered within payload
    - `request_body` string — The JSON stringified payload that was delivered to the webhook endpoint.
    - `response_body` string — The JSON stringified response that was returned from the webhook endpoint.
    - `retry_scheduled` boolean — If the request has not hit the max retry limit and will be retried.
    - `attempts` object[] — record of each attempt to call webhook endpoint
      - `timestamp` string — ISO Date and time when the request was made.
      - `execution_attempt` number — Number of attempts webhook endpoint was called before a success was returned or eventually failed
      - `status_code` integer — HTTP Status code that was returned.
      - `success` boolean — Whether or not the request was successful.
  - `meta` Meta — Response metadata
    - `items_on_page` integer — Number of items returned in the data property of the response
    - `cursors` object — Cursors to navigate to previous or next pages through the API
      - `previous` string, nullable — Cursor to navigate to the previous page of results through the API
      - `current` string, nullable — Cursor to navigate to the current page of results through the API
      - `next` string, nullable — Cursor to navigate to the next page of results through the API
    - `total_count` integer — Number of records available in total for this resource
    - `warnings` object[], nullable — Non-fatal warnings emitted when optional workflow steps failed. Present only when at least one step degraded; the response status remains 200.
      - `type` string — Discriminator for the warning kind.
      - `status_code` integer, nullable — HTTP status code returned by the failed downstream request, when available.
      - `error` string, nullable — Short error description from the downstream provider, when available.
      - `operation` string, nullable — Identifier of the workflow step that failed.
      - `message` string, nullable — Detailed message from the downstream provider, when available.
  - `links` Links — Links to navigate to previous or next pages through the API
    - `previous` string, nullable — Link to navigate to the previous page through the API
    - `current` string — Link to navigate to the current page through the API
    - `next` string, nullable — Link to navigate to the previous page through the API
  - `_raw` Raw, nullable — Raw response from the integration when raw=true query param is provided

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required
- `404` — The specified resource was not found
- `422` — Unprocessable
- `default` — Unexpected error

---

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