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

# Listing webhook events

> Returns a paginated list of webhook delivery events for a specific webhook, including delivery status, response codes, and retry information.



## OpenAPI

````yaml GET /webhooks/{webhookId}/events
openapi: 3.0.1
info:
  title: OpenAPI
  description: Tally's API
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.tally.so
security:
  - bearerAuth: []
paths:
  /webhooks/{webhookId}/events:
    get:
      tags:
        - Webhooks
      summary: List webhook events
      description: >-
        Returns a paginated list of webhook delivery events for a specific
        webhook, including delivery status, response codes, and retry
        information.
      parameters:
        - name: webhookId
          in: path
          required: true
          description: The ID of the webhook
          schema:
            type: string
        - name: page
          in: query
          required: false
          description: 'Page number for pagination (default: 1)'
          schema:
            type: number
      responses:
        '200':
          description: List of webhook events
          content:
            application/json:
              schema:
                type: object
                properties:
                  page:
                    type: number
                    description: Current page number
                  limit:
                    type: number
                    description: Number of events per page (25)
                  hasMore:
                    type: boolean
                    description: Whether there are more pages available
                  totalNumberOfEvents:
                    type: number
                    description: Total number of webhook events
                  events:
                    type: array
                    description: List of webhook events
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Event ID
                        webhookId:
                          type: string
                          description: Webhook ID
                        webhookUrl:
                          type: string
                          description: The URL the webhook was sent to
                        eventType:
                          type: string
                          enum:
                            - FORM_RESPONSE
                          description: Type of event
                        deliveryStatus:
                          type: string
                          enum:
                            - QUEUED
                            - SUCCEEDED
                            - FAILED
                            - DROPPED
                          description: Delivery status of the webhook
                        statusCode:
                          type: number
                          nullable: true
                          description: HTTP status code returned by the webhook endpoint
                        response:
                          type: string
                          nullable: true
                          description: Response body from the webhook endpoint
                        retry:
                          type: number
                          description: Number of retry attempts
                        payload:
                          type: object
                          description: The webhook payload that was sent
                        createdAt:
                          type: string
                          format: date-time
                          description: When the event was created
                        updatedAt:
                          type: string
                          format: date-time
                          description: When the event was last updated
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Webhook not found
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````