> ## Documentation Index
> Fetch the complete documentation index at: https://developers.stablepay.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Webhook Events

> Paginated delivery event log for the authenticated tenant, newest first. Shows status, attempt count, and last error for each event.



## OpenAPI

````yaml GET /v1/webhooks/events
openapi: 3.0.3
info:
  title: Stablepay Money API
  description: >
    The Stablepay Money API enables wallet issuers to execute stablecoin-to-fiat

    payouts across Sub-Saharan Africa via M-Pesa, mobile money, and bank
    transfers.
  version: 0.5.0
  contact:
    name: Stablepay Engineering
    email: hello@stablepay.io
servers:
  - url: https://api.stablepay.ai
    description: Production
security:
  - BearerAuth: []
tags:
  - name: Health
    description: Service liveness check.
  - name: FX
    description: Live FX rate conversion between USDC and local fiat currencies.
  - name: Payments
    description: Submit and track stablecoin-to-fiat payout requests.
  - name: Balances
    description: >-
      Live on-chain USDC and native token balances for the tenant's custody
      wallets.
  - name: Analytics
    description: >-
      Pre-aggregated payment analytics — volume, success rates, corridor
      breakdowns, and daily time series.
  - name: Customers
    description: |
      KYC API for DeFi wallets. Onboard and verify your end-users, then link
      their wallet addresses so verified identity travels with their on-chain
      activity.
  - name: Webhooks
    description: Register endpoints and manage outbound event delivery.
  - name: Admin
    description: >-
      Ops-only endpoints for tenant management and payment operations. Requires
      an admin-scoped API key.
paths:
  /v1/webhooks/events:
    get:
      tags:
        - Webhooks
      summary: List webhook events
      description: >-
        Paginated delivery event log for the authenticated tenant, newest first.
        Shows status, attempt count, and last error for each event.
      operationId: listWebhookEvents
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
            default: 20
            maximum: 100
        - name: offset
          in: query
          schema:
            type: integer
            default: 0
      responses:
        '200':
          description: Event log.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/WebhookEventResponse'
components:
  schemas:
    WebhookEventResponse:
      type: object
      properties:
        id:
          type: string
          format: uuid
        eventType:
          type: string
          example: payment.succeeded
        entityId:
          type: string
          example: pay_01HV8KZMRJPQR9S7T3XABCDEF
        url:
          type: string
          format: uri
        status:
          type: string
          enum:
            - pending
            - delivered
            - failed
        attempt:
          type: integer
        lastError:
          type: string
          nullable: true
        nextRetryAt:
          type: string
          format: date-time
          nullable: true
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
      required:
        - id
        - eventType
        - entityId
        - url
        - status
        - attempt
        - lastError
        - nextRetryAt
        - createdAt
        - updatedAt
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: |
        Stablepay API key. Include as `Authorization: Bearer <key>`.

````