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

# List webhook delivery logs

> Returns time-ordered webhook delivery logs. Delivery state may reflect asynchronous retry workers.



## OpenAPI

````yaml /api/openapi.json get /v1/webhooks/logs
openapi: 3.1.0
info:
  title: Kavenio API
  version: 1.0.0
  license:
    name: Proprietary
    url: https://kavenio.com/terms
  description: Generated OpenAPI document for the stable Kavenio public API.
servers:
  - url: https://api.kavenio.com
security:
  - bearerAuth: []
tags:
  - name: API keys
    description: Manage Kavenio API keys for the authenticated user.
  - name: Integrations
    description: Connect automation clients and manage workflow subscriptions.
  - name: Feature requests
    description: Submit feature requests from authenticated users.
  - name: Posts
    description: Create, schedule, update, and manage post lifecycle actions.
  - name: Queue
    description: Manage reusable post queue schedules and preview slots.
  - name: Media
    description: Upload, presign, and validate media assets.
  - name: Validation
    description: Validate post payloads and platform content length limits.
  - name: Connect
    description: Start and complete account connection flows.
  - name: Accounts
    description: Manage connected social accounts and account health.
  - name: Telegram
    description: Manage Telegram-specific connected account settings.
  - name: Discord
    description: Manage Discord messages, roles, pins, events, and settings.
  - name: Google Business
    description: Manage Google Business locations, reviews, and helpers.
  - name: Ads
    description: Create, read, cancel, and inspect advertising resources.
  - name: Ad audiences
    description: Manage advertising audiences and audience members.
  - name: Ad catalogs
    description: Inspect advertising catalogs and product sets.
  - name: Ad targeting
    description: Search targeting entities and estimate audience reach.
  - name: Ad conversions
    description: Manage conversion destinations and send conversion events.
  - name: Ad leads
    description: Manage lead forms and retrieve advertising leads.
  - name: Tracking tags
    description: Manage Meta tracking tags and tag sharing.
  - name: Platform credentials
    description: Manage organization platform app credentials.
  - name: Analytics
    description: Read provider analytics and operational inbox data.
  - name: WhatsApp conversions
    description: Read and send WhatsApp conversion events.
  - name: Activity
    description: Read operational activity events.
  - name: Webhooks
    description: Manage webhook endpoints and delivery logs.
paths:
  /v1/webhooks/logs:
    get:
      tags:
        - Webhooks
      summary: List webhook delivery logs
      description: >-
        Returns time-ordered webhook delivery logs. Delivery state may reflect
        asynchronous retry workers.
      operationId: listWebhookDeliveryLogs
      parameters:
        - in: query
          name: endpointId
          schema:
            type: string
            minLength: 16
            maxLength: 16
            pattern: ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$
        - in: query
          name: eventId
          schema:
            type: string
            minLength: 16
            maxLength: 16
            pattern: ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$
        - in: query
          name: eventType
          schema:
            type: string
            enum:
              - post.scheduled
              - post.updated
              - post.published
              - post.unpublished
              - post.failed
              - post.partial
              - post.recycled
              - account.connected
              - account.disconnected
              - ad.created
              - ad.status_changed
              - account.ads.initial_sync_completed
              - webhook.test
        - in: query
          name: status
          schema:
            type: string
            enum:
              - pending
              - delivered
              - retrying
              - dead_lettered
              - cancelled
        - in: query
          name: page
          schema:
            type: integer
            minimum: 1
            maximum: 9007199254740991
        - in: query
          name: limit
          schema:
            type: integer
            minimum: 1
            maximum: 100
      responses:
        '200':
          description: Webhook delivery logs returned.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    x-kavenio-const: true
                  data:
                    type: object
                    properties:
                      deliveries:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              minLength: 16
                              maxLength: 16
                              pattern: >-
                                ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$
                            organizationId:
                              type: string
                              minLength: 1
                            endpointId:
                              type: string
                              minLength: 16
                              maxLength: 16
                              pattern: >-
                                ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$
                            eventId:
                              type: string
                              minLength: 16
                              maxLength: 16
                              pattern: >-
                                ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$
                            eventType:
                              type: string
                              enum:
                                - post.scheduled
                                - post.updated
                                - post.published
                                - post.unpublished
                                - post.failed
                                - post.partial
                                - post.recycled
                                - account.connected
                                - account.disconnected
                                - ad.created
                                - ad.status_changed
                                - account.ads.initial_sync_completed
                                - webhook.test
                            status:
                              type: string
                              enum:
                                - pending
                                - delivered
                                - retrying
                                - dead_lettered
                                - cancelled
                            attemptCount:
                              type: integer
                              minimum: 0
                              maximum: 9007199254740991
                            nextAttemptAt:
                              type: string
                              format: date-time
                              pattern: >-
                                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
                            lastStatusCode:
                              type: integer
                              minimum: 100
                              maximum: 599
                            lastError:
                              type: string
                              minLength: 1
                            responseBodySnippet:
                              type: string
                            deliveredAt:
                              type: string
                              format: date-time
                              pattern: >-
                                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
                            deadLetteredAt:
                              type: string
                              format: date-time
                              pattern: >-
                                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
                            createdAt:
                              type: string
                              format: date-time
                              pattern: >-
                                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
                            updatedAt:
                              type: string
                              format: date-time
                              pattern: >-
                                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
                            attempts:
                              type: array
                              items:
                                type: object
                                properties:
                                  id:
                                    type: string
                                    minLength: 16
                                    maxLength: 16
                                    pattern: >-
                                      ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$
                                  deliveryId:
                                    type: string
                                    minLength: 16
                                    maxLength: 16
                                    pattern: >-
                                      ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$
                                  endpointId:
                                    type: string
                                    minLength: 16
                                    maxLength: 16
                                    pattern: >-
                                      ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$
                                  eventId:
                                    type: string
                                    minLength: 16
                                    maxLength: 16
                                    pattern: >-
                                      ^[abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ]{16}$
                                  eventType:
                                    type: string
                                    enum:
                                      - post.scheduled
                                      - post.updated
                                      - post.published
                                      - post.unpublished
                                      - post.failed
                                      - post.partial
                                      - post.recycled
                                      - account.connected
                                      - account.disconnected
                                      - ad.created
                                      - ad.status_changed
                                      - account.ads.initial_sync_completed
                                      - webhook.test
                                  attemptNumber:
                                    type: integer
                                    exclusiveMinimum: 0
                                    maximum: 9007199254740991
                                  status:
                                    type: string
                                    enum:
                                      - succeeded
                                      - failed
                                  statusCode:
                                    type: integer
                                    minimum: 100
                                    maximum: 599
                                  durationMs:
                                    type: integer
                                    minimum: 0
                                    maximum: 9007199254740991
                                  error:
                                    type: string
                                    minLength: 1
                                  responseBodySnippet:
                                    type: string
                                  attemptedAt:
                                    type: string
                                    format: date-time
                                    pattern: >-
                                      ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
                                required:
                                  - id
                                  - deliveryId
                                  - endpointId
                                  - eventId
                                  - eventType
                                  - attemptNumber
                                  - status
                                  - attemptedAt
                                additionalProperties: false
                          required:
                            - id
                            - organizationId
                            - endpointId
                            - eventId
                            - eventType
                            - status
                            - attemptCount
                            - createdAt
                            - updatedAt
                          additionalProperties: false
                      pagination:
                        type: object
                        properties:
                          page:
                            type: integer
                            minimum: 1
                            maximum: 9007199254740991
                          limit:
                            type: integer
                            minimum: 1
                            maximum: 9007199254740991
                          total:
                            type: integer
                            minimum: 0
                            maximum: 9007199254740991
                          hasMore:
                            type: boolean
                        required:
                          - page
                          - limit
                          - total
                          - hasMore
                        additionalProperties: false
                    required:
                      - deliveries
                      - pagination
                    additionalProperties: false
                required:
                  - ok
                  - data
                additionalProperties: false
        '401':
          description: Authentication failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    x-kavenio-const: false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        minLength: 1
                      message:
                        type: string
                        minLength: 1
                      details: {}
                    required:
                      - code
                      - message
                    additionalProperties: false
                required:
                  - ok
                  - error
                additionalProperties: false
        '422':
          description: Query parameter validation failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    x-kavenio-const: false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        minLength: 1
                      message:
                        type: string
                        minLength: 1
                      details: {}
                    required:
                      - code
                      - message
                    additionalProperties: false
                required:
                  - ok
                  - error
                additionalProperties: false
        '500':
          description: Webhook delivery log lookup failed.
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                    x-kavenio-const: false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        minLength: 1
                      message:
                        type: string
                        minLength: 1
                      details: {}
                    required:
                      - code
                      - message
                    additionalProperties: false
                required:
                  - ok
                  - error
                additionalProperties: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Clerk session or OAuth token

````