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

# Webhook Delivery Logs

> The last delivery attempts of a webhook, to see what reached your bot

The last 100 attempts, newest first. Each row has the body sent (`payload`), what your endpoint answered (`response`,
`statusCode`) and, for a failed attempt, `errorMessage`. After 5 failed attempts a delivery stops: the last row shows
why (see [Retries](https://docs.minimo.it/api-reference/whatsapp-transport/webhooks.md#retries-and-idempotency)).

## Permissions

The API key needs the **WhatsApp** permission.


## OpenAPI

````yaml get /public/v1/webhooks/registrations/{id}/logs
openapi: 3.1.0
info:
  title: API Documentation
  description: Documentation for transactional and subscribe APIs
  version: 1.0.0
servers:
  - url: https://app.minimo.it
security:
  - bearerAuth: []
paths:
  /public/v1/webhooks/registrations/{id}/logs:
    servers:
      - url: https://api.minimo.it
    get:
      summary: Webhook delivery logs
      description: >-
        The last 100 delivery attempts, newest first: one row per attempt,
        including the final failed one.
      operationId: listWebhookDeliveryLogs
      parameters:
        - name: id
          in: path
          required: true
          description: The webhook `id` from Register Webhook or List Webhooks.
          schema:
            type: integer
      responses:
        '200':
          description: Delivery attempts
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/WebhookDeliveryLog'
              example:
                data:
                  - id: 7781
                    webhook: 42
                    payload:
                      version: '1'
                      event: whatsapp.message.received
                      ...: ...
                    response: OK
                    statusCode: 200
                    errorMessage: null
                    scheduledSendAt: null
                    sentAt: '2026-11-13T10:05:02.000Z'
                    createdAt: '2026-11-13T10:05:02.000Z'
                    deleted: false
        '401':
          description: >-
            Missing or invalid API key, or a key without the `WhatsApp`
            permission.
        '404':
          description: No webhook with this id in your workspace.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: FAIL
                  message:
                    type: string
      security:
        - bearerAuth: []
      x-codeSamples:
        - label: CLI
          lang: cURL
          source: |-
            curl --request GET \
              --url 'https://api.minimo.it/public/v1/webhooks/registrations/42/logs' \
              --header 'Authorization: Bearer {{BEARER_TOKEN}}'
        - lang: JavaScript
          source: >-
            const res = await
            fetch('https://api.minimo.it/public/v1/webhooks/registrations/42/logs',
            {
              method: 'GET',
              headers: {
                'Authorization': 'Bearer {{BEARER_TOKEN}}',
              },
            });

            const { data } = await res.json();

            console.log(data);
        - lang: Python
          source: |-
            import requests

            res = requests.get(
                'https://api.minimo.it/public/v1/webhooks/registrations/42/logs',
                headers={'Authorization': 'Bearer {{BEARER_TOKEN}}'},
            )
            print(res.json())
components:
  schemas:
    WebhookDeliveryLog:
      type: object
      description: One delivery attempt.
      properties:
        id:
          type: integer
        webhook:
          type: integer
          description: The webhook id.
        payload:
          type: object
          description: The body that was delivered.
        response:
          description: What your endpoint answered.
          nullable: true
        statusCode:
          type: integer
          description: HTTP status your endpoint answered.
        errorMessage:
          type: string
          nullable: true
          description: Why the attempt failed.
        scheduledSendAt:
          type: string
          format: date-time
          nullable: true
        sentAt:
          type: string
          format: date-time
          nullable: true
        createdAt:
          type: string
          format: date-time
        deleted:
          type: boolean
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: mn-API_CLIENT_ID-API_KEY

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.