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

# List events

> Immutable event log for reconciliation and backfill. Use event `id` as the consumer idempotency key.



## OpenAPI

````yaml /openapi/program.openapi.json get /events
openapi: 3.1.0
info:
  title: Questra Program API
  version: 0.0.1
  description: >-
    REST API for the Questra Program product. Browser users authenticate through
    Questra Auth SSO; automation uses workspace-scoped API keys (`Authorization:
    Bearer qpk_live_…`). API keys carry scopes enforced before handlers.
    Outbound webhooks follow Standard Webhooks (at-least-once delivery;
    consumers must be idempotent).
servers:
  - url: /v1
    description: Program API base path
security: []
paths:
  /events:
    get:
      tags:
        - Events
      summary: List events
      description: >-
        Immutable event log for reconciliation and backfill. Use event `id` as
        the consumer idempotency key.
      responses:
        '200':
          description: Event list
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookEventList'
components:
  schemas:
    WebhookEventList:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/WebhookEvent'
      required:
        - data
    WebhookEvent:
      type: object
      properties:
        id:
          type: string
          format: uuid
        type:
          $ref: '#/components/schemas/WebhookEventType'
        api_version:
          type: string
          example: '2026-07-13'
        created_at:
          type: string
          format: date-time
        data:
          type: object
          additionalProperties: {}
          description: >-
            Event payload; shape is defined per type in the webhook event
            registry.
        pending_deliveries:
          type: integer
          minimum: 0
      required:
        - id
        - type
        - api_version
        - created_at
        - data
        - pending_deliveries
    WebhookEventType:
      type: string
      enum:
        - survey.created
        - survey.updated
        - survey.deleted
        - file.created
        - file.updated
        - file.ready
        - file.deleted
        - questionnaire.updated
        - questionnaire.clarifications.updated
        - survey.audit.updated
        - workflow.started
        - workflow.updated
        - workflow.finished
        - content.updated

````