---
title: "Inspect an event and every delivery attempt"
method: GET
path: "/credits/webhooks/events/{eventId}"
tags: ["Webhooks"]
---

# Inspect an event and every delivery attempt

`GET /credits/webhooks/events/{eventId}`

## Request

- Base URL: `https://api.paywithlocus.com/api`
- URL: `https://api.paywithlocus.com/api/credits/webhooks/events/{eventId}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Returns one webhook event with its immutable envelope and every delivery attempt. Use it to debug failed deliveries. Returns 404 when the event belongs to another workspace.

## Path parameters

- `eventId` string, uuid, required

## Response `200`

Immutable envelope and delivery history

- WebhookEventDetail
  - `success` unknown, required
  - `event` object, required
    - `id` string, uuid, required
    - `type` 'credits.topup.completed' | 'credits.topup.failed' | 'credits.burn.completed' | 'credits.burn.failed' | 'credits.refund.issued' | 'credits.dispute.opened' | 'credits.dispute.closed' | 'credits.balance.changed' | 'credits.balance.low' | 'credits.account.frozen' | 'credits.usage_drift.detected' | 'credits.usage_drift.resolved', required
    - `api_version` '2026-08-13', required
    - `created_at` string, date-time, required
    - `sequence` string, required
    - `tenant_id` string, uuid, required
    - `data` union, required
      - WebhookTopupCompletedData
        - `externalUserId` string, nullable, required
        - `amountUsd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
        - `balanceUsd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
        - `reference` string, required
        - `source` 'checkout_session' | 'auto_recharge', required
        - `bonusUsd` string: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
        - `metadata` object, nullable, required
      - WebhookTopupFailedData
        - `externalUserId` string, nullable, required
        - `reason` string, required
        - `reference` string, required
        - `paymentIntentId` string
      - WebhookBurnCompletedData
        - `apiCallId` string, required
        - `provider` string, required
        - `endpoint` string, required
        - `amountUsd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
        - `balanceUsd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
        - `mode` 'platform' | 'end_user', required
        - `externalUserId` string, nullable, required
      - WebhookBurnFailedData
        - `apiCallId` string, required
        - `provider` string, required
        - `endpoint` string, required
        - `amountUsd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
        - `mode` 'platform' | 'end_user', required
        - `externalUserId` string, nullable, required
        - `reason` string, required
      - union
        - object
          - `apiCallId` string, required
          - `reference` string, required
          - `provider` string, required
          - `endpoint` string, required
          - `amountUsd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
          - `mode` 'platform' | 'end_user', required
          - `externalUserId` string, nullable, required
          - `reason` 'upstream_failure', required
        - object
          - `externalUserId` string, nullable, required
          - `amountUsd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
          - `reason` 'account_frozen', required
          - `reference` string, required
        - object
          - `accountId` string, required
          - `chargeId` string, required
          - `amountUsd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
          - `marginClawbackUsd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
          - `bonusClawbackUsd` string: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
          - `cumulativeRefundedCents` integer, required
          - `reason` 'stripe_refund', required
          - `reference` string, required
        - object
          - `externalUserId` string, nullable, required
          - `amountUsd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
          - `reason` 'funding_unavailable', required
          - `reference` string, required
      - WebhookDisputeOpenedData
        - `accountId` string, required
        - `disputeId` string, required
        - `amountUsd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
        - `clawbackUsd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
        - `marginClawbackUsd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
        - `bonusClawbackUsd` string: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
        - `status` string, required
      - WebhookDisputeClosedData
        - `accountId` string, nullable, required
        - `disputeId` string, required
        - `outcome` string, required
      - WebhookBalanceChangedData
        - `apiCallId` string
        - `reference` string, required
        - `externalUserId` string, nullable, required
        - `deltaUsd` string, required: Exact signed USD decimal string with at most six fractional digits.
        - `balanceUsd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
        - `reason` 'topup' | 'burn' | 'refund' | 'dispute_reversal' | 'allocate' | 'deallocate' | 'expiration', required
      - WebhookBalanceLowData
        - `balanceUsd` string: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
        - `thresholdUsd` string: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
        - `reason` string, required
        - `paymentIntentId` string
      - WebhookAccountFrozenData
        - `accountId` string, required
        - `disputeId` string, required
        - `reason` 'dispute_opened', required
    - `retained_until` string, date-time, required
    - `deliveries` WebhookDelivery[], required
      - `id` string, uuid, required
      - `attempt` integer, required
      - `destination_url` string, uri, required
      - `status` 'pending' | 'delivering' | 'delivered' | 'failed', required
      - `manual_replay` boolean, required
      - `scheduled_at` string, date-time, required
      - `started_at` string, date-time, nullable
      - `finished_at` string, date-time, nullable
      - `http_status` integer, nullable
      - `response_body` string, nullable
      - `error` string, nullable

## Other responses

- `404`: Event not found in this tenant

---

[API](https://skmtc.dev/paywithlocus/apis/locus-pro-api.md) - [All operations](https://skmtc.dev/paywithlocus/apis/locus-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paywithlocus/apis/locus-pro-api/revisions/aab8fa5d6cef?raw)