Skip to main content
GET
Listar Eventos de Webhook

Visão Geral

Retorna uma lista paginada dos eventos de webhook emitidos pelo seller autenticado — entregues, pendentes e com falha. É a chamada por trás da aba Eventos em Configurações → Webhooks do dashboard. Disponível a partir da v0.10.3. Aceita chave de API (sk_test_… / sk_live_…) ou JWT do dashboard.

Exemplo de Requisição

Parâmetros de Query

status
string
Filtra por status de entrega. Valores: pending, success, failed.
eventType
string
Filtra por tipo de evento (ex: transaction.payment.succeeded, scheduled_charge.cycle_failed). Use os mesmos identificadores documentados em Webhooks → Eventos Disponíveis.
endpointId
number
Restringe a eventos entregues a um endpoint específico.
page
number
default:"1"
Página da paginação.
limit
number
default:"20"
Itens por página (máx. 100).

Resposta

Campos

CampoTipoDescrição
idnumberID numérico do evento (use em get e retry)
endpointIdnumberID do endpoint configurado em Configurações → Webhooks
eventTypestringTipo do evento Garu (ex: transaction.payment.succeeded)
statusstringpending, success ou failed
attemptsnumberQuantas tentativas de entrega foram feitas
lastResponseStatusnumber|nullCódigo HTTP da última resposta do seu endpoint
deliveredAtstring|nullISO timestamp da entrega bem-sucedida (se status success)
payloadobjectPayload completo enviado ao seu endpoint
Os eventos ficam retidos por 30 dias. Para auditoria de longo prazo, persista os webhooks no seu lado conforme os recebe.