---
title: "List webhook delivery logs"
method: GET
path: "/api/agents/webhook-logs"
tags: ["agents"]
---

# List webhook delivery logs

`GET /api/agents/webhook-logs`

## Request

- Base URL: `https://api.depixapp.com`
- URL: `https://api.depixapp.com/api/agents/webhook-logs`
- Auth: none required

The 50 most recent delivery attempts of checkout.*, deposit.* and withdraw.* events to this account's callback URLs, newest first — the agent-side audit of what was delivered, retried or failed. Bodies are omitted in the list; fetch one log by id for the payloads. Auth: agent keypair signature. Requires an ACTIVE merchant profile (a suspended account gets 403).

## Response `200`

Delivery attempts, newest first.

- WebhookLogListResponse: The 50 most recent webhook delivery attempts for this account, newest first. Bodies are omitted here — fetch one log by id for the request/response payloads.
  - `logs` object[], required: Delivery attempts, newest first (fixed window of 50).
    - `id` string, required: Delivery log id — use it on the detail endpoint.
    - `checkout_id` string, nullable, required: Checkout id (chk_*) for checkout.* events; null for deposit.*/withdraw.* events.
    - `event` string, required: Event name delivered (e.g. checkout.completed, deposit.depix_sent, withdraw.sent).
    - `url` string, required: The callback URL the event was delivered to.
    - `status_code` integer, nullable, required: HTTP status answered by the receiver — null when the request failed before a response (timeout, connection error).
    - `error` string, nullable, required: Transport/delivery error message, or null when a response was received.
    - `attempt` integer, required: 1-based attempt number within the retry schedule (max 6).
    - `sent_at` string, required: Delivery attempt timestamp (RFC 3339 UTC).

## Other responses

- `401`: Signature chain failed or unknown agent key.
- `403`: Blocked, or the account has no ACTIVE merchant profile.
- `429`: Rate limited (per-IP, per-key or per-merchant window). Retry after `retry_after` seconds (also in the Retry-After header).
- `503`: Nonce store unavailable (fail-CLOSED) OR the agent program is globally disabled (agents_disabled).

---

[API](https://skmtc.dev/depixapp/apis/depix-api.md) · [All operations](https://skmtc.dev/depixapp/apis/depix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/depixapp/apis/depix-api/revisions/04094536dd0f?raw)