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

# List webhook deliveries

> Returns paginated list of webhook deliveries for the tenant.

Use this to monitor webhook delivery status and debug failed deliveries.

**Status values:**
- `pending`: Awaiting delivery or retry
- `delivered`: Successfully delivered
- `failed`: Failed, retry scheduled
- `dead`: Permanently failed after max attempts



## OpenAPI

````yaml /api/openapi.json get /v1/alerts/deliveries
openapi: 3.1.0
info:
  title: MeshQu API
  description: >-
    Governance infrastructure for policy-aware AI decisions. MeshQu does not run
    tools. It governs decisions about them.
  version: 1.9.0
  contact:
    name: MeshQu Support
    email: support@meshqu.com
  license:
    name: Proprietary
servers:
  - url: https://api.meshqu.com
    description: Deployed environment
security:
  - apiKey: []
    tenantId: []
tags:
  - name: Operations
    description: Health, readiness, metrics, and signing keys
  - name: Policies
    description: Policy management
  - name: Policy Groups
    description: Policy group management
  - name: Decisions
    description: Policy evaluation and recording
  - name: Chains
    description: Decision chain verification and sealing
  - name: Receipts
    description: Public receipt and bundle retrieval
  - name: Forms
    description: Attestation forms and public submission
  - name: Alerts
    description: Alert management and webhooks
  - name: Audit
    description: Audit log retrieval and verification
  - name: API Keys
    description: API key administration
  - name: Admin
    description: Tenant and platform administration
  - name: Dashboard
    description: Console dashboard data
  - name: Metrics
    description: Decision and overview metrics
  - name: Fields
    description: Field catalogue
  - name: Settings
    description: Tenant settings
  - name: Rule Creation Logs
    description: Rule authoring telemetry
paths:
  /v1/alerts/deliveries:
    get:
      tags:
        - Alerts
      summary: List webhook deliveries
      description: |-
        Returns paginated list of webhook deliveries for the tenant.

        Use this to monitor webhook delivery status and debug failed deliveries.

        **Status values:**
        - `pending`: Awaiting delivery or retry
        - `delivered`: Successfully delivered
        - `failed`: Failed, retry scheduled
        - `dead`: Permanently failed after max attempts
      operationId: getV1AlertsDeliveries
      parameters:
        - schema:
            minimum: 1
            maximum: 100
            default: 50
            type: integer
          in: query
          name: limit
          required: false
        - schema:
            minimum: 0
            default: 0
            type: integer
          in: query
          name: offset
          required: false
        - schema:
            anyOf:
              - type: string
                enum:
                  - pending
              - type: string
                enum:
                  - delivered
              - type: string
                enum:
                  - failed
              - type: string
                enum:
                  - dead
          in: query
          name: status
          required: false
        - schema:
            format: uuid
            type: string
          in: query
          name: subscription_id
          required: false
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          format: uuid
                          type: string
                        tenant_id:
                          format: uuid
                          type: string
                        subscription_id:
                          format: uuid
                          type: string
                        event_type:
                          type: string
                        payload:
                          description: Webhook payload
                        status:
                          anyOf:
                            - type: string
                              enum:
                                - pending
                            - type: string
                              enum:
                                - delivered
                            - type: string
                              enum:
                                - failed
                            - type: string
                              enum:
                                - dead
                        attempts:
                          minimum: 0
                          type: integer
                        max_attempts:
                          minimum: 1
                          type: integer
                        next_attempt_at:
                          anyOf:
                            - format: date-time
                              type: string
                            - type: 'null'
                        last_status_code:
                          anyOf:
                            - type: integer
                            - type: 'null'
                        last_error:
                          anyOf:
                            - type: string
                            - type: 'null'
                        created_at:
                          format: date-time
                          type: string
                        delivered_at:
                          anyOf:
                            - format: date-time
                              type: string
                            - type: 'null'
                        dead_at:
                          anyOf:
                            - format: date-time
                              type: string
                            - type: 'null'
                      required:
                        - id
                        - tenant_id
                        - subscription_id
                        - event_type
                        - payload
                        - status
                        - attempts
                        - max_attempts
                        - next_attempt_at
                        - last_status_code
                        - last_error
                        - created_at
                        - delivered_at
                        - dead_at
                  total:
                    type: integer
                  limit:
                    type: integer
                  offset:
                    type: integer
                required:
                  - items
                  - total
                  - limit
                  - offset
components:
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      bearerFormat: mqu_<token>
      description: >-
        MeshQu API key passed as a bearer token: `Authorization: Bearer mqu_…`.
        Mint one in the console (Settings → API keys).
    tenantId:
      type: apiKey
      name: X-MeshQu-Tenant-Id
      in: header
      description: >-
        Tenant UUID for multi-tenant isolation. Required on all authenticated
        routes — validated before authentication (middleware/tenant.ts), so a
        missing or non-UUID header returns 400 (MISSING_TENANT_ID /
        INVALID_TENANT_ID) before the API key is checked.

````