> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rails.wayex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List webhook deliveries

> Returns recent delivery attempts for one webhook subscription, including their outcome.

## What this endpoint does

Returns recent delivery attempts for one webhook subscription, including their outcome.

## When to use it

Use it to diagnose missing events, non-2xx responses, or repeated delivery attempts.

## Before you call

Authenticate with an API key that can read webhooks, and pass a subscription ID owned by the same tenant account.

## Money and balance effect

This is a read-only request. It does not reserve, debit, credit, or settle money.

## States and completion

Delivery success means your endpoint returned an accepted response. Events remain at-least-once and unordered, so deduplicate by event ID.

## Safe retries

GET requests are read-only and may be retried with normal exponential backoff. Do not send an `Idempotency-Key`.

Read [Webhooks](/console/developers) for the complete workflow.


## OpenAPI

````yaml /api-reference/openapi.json get /v1/webhooks/{id}/deliveries
openapi: 3.0.0
info:
  title: Wayex API
  description: >-
    Wayex APIs for direct customer payment routes and isolated, prefunded
    Treasury accounts. Each API key is bound to one tenant account and its own
    wallet, settings, webhooks, and reporting.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.sandbox.wayex.com
    description: Sandbox integration environment
security:
  - Bearer: []
  - ApiKey: []
tags:
  - name: Treasury
    description: >-
      Prefunded AUD and stablecoin wallets for one isolated tenant account.
      Fund, pay, convert, withdraw, track, and reconcile without selecting
      another account.
  - name: Customers
    description: >-
      Onboard end customers, run verification, and manage each customer's
      entitlements.
  - name: Payment routes
    description: >-
      Standing deposit instructions per customer. When a customer funds a route,
      Wayex auto-converts at the live rate and pays out/sends — no quote, no
      lock.
  - name: Transfers
    description: >-
      Read the conversion records produced when customers fund payment routes —
      the live activity feed and per-conversion lifecycle timeline.
  - name: Rates
    description: >-
      The live indicative AUD↔stablecoin rate right now — the all-in rate Wayex
      quotes. Indicative only; the binding price is struck when a route's funds
      land.
  - name: Revenue
    description: Your developer-fee revenue over time.
  - name: Invoices
    description: >-
      Your monthly invoices — Wayex platform fees due, net of your accrued
      developer-fee credit.
  - name: Webhooks
    description: Subscribe to HMAC-signed event webhooks and inspect deliveries.
  - name: API keys
    description: Create, list, and rotate API keys for programmatic access.
  - name: Fees
    description: >-
      Configure your developer fee — the markup withheld from each conversion
      and credited against your monthly invoice.
  - name: Invitations
    description: Accept a team invitation and activate your account.
paths:
  /v1/webhooks/{id}/deliveries:
    get:
      tags:
        - Webhooks
      summary: List webhook deliveries
      description: >-
        Returns recent delivery attempts for one webhook subscription, including
        their outcome. Use it to diagnose missing events, non-2xx responses, or
        repeated delivery attempts.
      operationId: WebhookController2_deliveries_v1
      parameters:
        - name: id
          required: true
          in: path
          schema:
            type: string
      responses:
        '200':
          description: The delivery history for the subscription (newest first).
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      description: A single webhook delivery and its true outcome.
                      type: object
                      properties:
                        id:
                          description: >-
                            The delivery id — `<subscriptionId>:<eventId>`,
                            stable across retries.
                          type: string
                        subscriptionId:
                          description: The subscription this delivery belongs to.
                          type: string
                        eventId:
                          description: >-
                            The id of the delivered event (used by consumers to
                            dedupe).
                          type: string
                        eventType:
                          description: The type of the delivered event.
                          type: string
                          enum:
                            - counterparty.created
                            - counterparty.invited
                            - counterparty.activated
                            - customer.created
                            - kyc.updated
                            - payment_route.created
                            - payment_route.activity.created
                            - rate.updated
                            - quote.created
                            - transfer.created
                            - transfer.updated
                            - transfer.completed
                            - treasury.wallet.updated
                            - treasury.payin.updated
                            - treasury.deposit.updated
                            - treasury.payout.updated
                            - treasury.withdrawal.updated
                            - treasury.conversion.updated
                            - approval.created
                            - approval.resolved
                        status:
                          description: >-
                            The TRUE state of this delivery. `pending` = queued,
                            not yet attempted. `failed` = attempted, no 2xx, a
                            retry is scheduled. `delivered` = your endpoint
                            returned a 2xx. `dead` = the retry budget is
                            exhausted and it will not be retried again.
                          type: string
                          enum:
                            - pending
                            - failed
                            - delivered
                            - dead
                        attempts:
                          description: How many attempts have actually been made.
                          type: integer
                        nextAttemptAt:
                          description: >-
                            When the next retry is due (ISO 8601). Meaningless
                            once terminal.
                          type: string
                        lastStatusCode:
                          description: >-
                            The HTTP status your endpoint returned on the last
                            attempt, if it responded.
                          type: integer
                        lastError:
                          description: >-
                            A machine reason code for the last failure (e.g.
                            `http_error`, `timeout`).
                          type: string
                        createdAt:
                          description: When the delivery was queued (ISO 8601).
                          type: string
                        updatedAt:
                          description: >-
                            When the delivery was last attempted/updated (ISO
                            8601).
                          type: string
                        deliveredAt:
                          description: >-
                            When a 2xx was actually received. Absent unless
                            status is `delivered`.
                          type: string
                      required:
                        - id
                        - subscriptionId
                        - eventId
                        - eventType
                        - status
                        - attempts
                        - nextAttemptAt
                        - createdAt
                        - updatedAt
                required:
                  - data
        '404':
          description: No such webhook subscription.
      security:
        - Bearer: []
        - ApiKey: []
components:
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: Wayex API key
      description: 'Send the same Wayex API key as `Authorization: Bearer <key>`.'
    ApiKey:
      type: apiKey
      in: header
      name: X-Api-Key
      description: A Wayex API key. Use a secret key for write operations.

````