---
title: "Listar Histórico De Eventos De Um Webhook"
method: GET
path: "/webhook/{hook_id}/events/"
tags: ["Webhook"]
---

# Listar Histórico De Eventos De Um Webhook

`GET /webhook/{hook_id}/events/`

Este endpoint permite que você recupere uma lista de todos os eventos associados a um webhook específico. Ele é útil para monitorar o status dos eventos enviados, incluindo detalhes sobre tentativas bem-sucedidas e falhas.

## Path parameters

- `hook_id` string, required

## Query parameters

- `events` V2PackagesEnterpriseSchemasWebhookWebhookEnumWebhookEventsEnum[], nullable — Filtro por eventos
- `created_at` string, nullable — Filtro por data de criação
- `last_status` 'pending' | 'sent' | 'failed'
- `page` integer — Page number
- `size` integer — Page size

## Response `200`

Retorno dos eventos de um webhook

- PageWebhookEventResponseDTOInput
  - `items` WebhookEventResponseDTOInput[], required
    - `id` string, required — Id único do evento
    - `event` 'vehicle_not_found' | 'vehicle_debt_not_found' | 'vehicle_debt_found' | 'vehicle_debt_search_error' | 'vehicle_enriched_partially' | 'vehicle_debt_unavailable' | 'webhook_validation' | 'payment_order_created' | 'payment_order_completed' | 'payment_order_failed' | 'autoradar_vehicle_debt_found' | 'autoradar_vehicle_debt_not_found' | 'autoradar_vehicle_due_debts' | 'autoradar_subscription_activated' | 'autoradar_subscription_activated_failed' | 'autoradar_subscription_deactivated' | 'autoradar_subscription_deactivated_failed' | 'payment_plan_created' | 'payment_plan_updated' | 'payment_plan_canceled' | 'payment_plan_item_created' | 'payment_plan_item_updated' | 'payment_plan_item_canceled' | 'payment_subscription_created' | 'payment_subscription_updated' | 'payment_subscription_canceled' | 'payment_subscriptionitem_created' | 'payment_subscriptionitem_updated' | 'payment_subscriptionitem_canceled' | 'payment_invoice_created' | 'payment_invoice_paid' | 'payment_invoice_payment_failed' | 'payment_invoice_canceled' | 'documents_crlv_request' | 'documents_crlv_issued' | 'documents_crlv_unavailable' | 'documents_crlv_incorrect_data' | 'documents_crlv_request_failed' | 'monitoring_search_result_event' | 'monitoring_create_subscription_event' | 'monitoring_create_subscription_event_failed' | 'monitoring_deactivate_subscription_event' | 'monitoring_deactivate_subscription_event_failed', required
    - `status` 'pending' | 'sent' | 'failed', required
    - `webhook` WebhookInfoDTO, required
      - `id` string, required — Identificador único do webhook
      - `resource` 'vehicle_debt' | 'vehicle_debt_batch' | 'checkout' | 'autoradar' | 'payment_recurrence' | 'documents' | 'monitoring'
      - `version` string — Versão do webhook
    - `data` object, required — Corpo do evento para ser enviado para o cliente
    - `attempts` object[] — Resposta do servidor recebida pelo webhook
  - `total` integer, nullable, required
  - `page` integer, nullable, required
  - `size` integer, nullable, required
  - `pages` integer, nullable

## Other responses

- `400` — Formato da requisição inválida
- `422` — Validation Error
- `500` — Erro interno
- `503` — Serviço temporariamente indisponível

---

[API](https://skmtc.net/usezapay/apis/zapi.md) · [All operations](https://skmtc.net/usezapay/apis/zapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usezapay/zapi/versions/50c96157fff4/schema)