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

# List Events

> Retrieve a paginated list of webhook events that have been generated for your account.

Retrieve a paginated list of webhook events that have been generated for your account. This allows you to view the history of webhook events and their delivery status.

## Overview

This endpoint returns all webhook events that have been generated for your account, including their status, delivery attempts, and acknowledgment status.

## Query Parameters

<ParamField query="page" type="integer">
  Page number for pagination
</ParamField>

<ParamField query="per_page" type="integer">
  Number of items per page
</ParamField>

## Response

<ResponseField name="data" type="object">
  Paginated response containing:

  * `total_pages`: Total number of pages
  * `current_page`: Current page number
  * `total_records`: Total number of webhook events
  * `next_page`: URL for next page
  * `previous_page`: URL for previous page
  * `items`: Array of webhook event objects
</ResponseField>

<ResponseField name="data.items[]" type="object">
  Each webhook event object includes:

  * `id`: Event UUID
  * `type`: Event type (e.g., "chargeback")
  * `event`: Event name (e.g., "transfer.fulfilled")
  * `data`: Event payload data
  * `attempts`: Number of delivery attempts
  * `acknowledged`: Whether event was acknowledged
  * `acknowledged_at`: Timestamp when acknowledged
  * `created_at`: Creation timestamp
  * `updated_at`: Last update timestamp
</ResponseField>


## OpenAPI

````yaml GET /webhooks/events
openapi: 3.0.0
info:
  title: Pooler Developer API
  description: >-
    Comprehensive API documentation for Pooler payment and financial services
    platform
  version: 1.0.0
servers:
  - url: https://api.usepooler.com
    description: Production server
  - url: https://sandbox.usepooler.com
    description: Sandbox server
security:
  - bearerAuth: []
paths:
  /webhooks/events:
    get:
      tags:
        - Webhooks
      summary: List Events
      description: >-
        Retrieve a paginated list of webhook events that have been generated for
        your account.
      operationId: listWebhookEvents
      parameters:
        - name: page
          in: query
          description: Page number for pagination
          schema:
            type: integer
        - name: per_page
          in: query
          description: Number of items per page
          schema:
            type: integer
      responses:
        '200':
          description: Webhook events retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedWebhookEventsResponse'
components:
  schemas:
    PaginatedWebhookEventsResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
        stan:
          type: string
          format: uuid
        data:
          $ref: '#/components/schemas/PaginatedWebhookEvents'
    PaginatedWebhookEvents:
      type: object
      properties:
        total_pages:
          type: integer
        current_page:
          type: integer
        total_records:
          type: integer
        next_page:
          type: string
        previous_page:
          type: string
        items:
          type: array
          items:
            $ref: '#/components/schemas/WebhookEvent'
    WebhookEvent:
      type: object
      properties:
        id:
          type: string
          format: uuid
        type:
          type: string
        event:
          type: string
        data:
          type: object
        attempts:
          type: integer
        acknowledged:
          type: boolean
        acknowledged_at:
          type: string
          format: date-time
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Bearer token authentication. Include your API key in the Authorization
        header as: Bearer {your_api_key}

````