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

# List webhook deliveries

> What we have tried to push, and what happened. Filter by endpoint and by state to answer "what is failing".

Your endpoint's response **body is never stored** — only the status code and a failure reason from a fixed set, since the body comes from an address you control and we do not persist what we fetch from it.

This is a debugging surface, not a second feed. To reconcile everything you should have received, walk [List ICP signals](/api-reference/icp-signal-watches/list-icp-signals) with its cursor.



## OpenAPI

````yaml /reference/openapi.yaml get /v2/webhook-deliveries
openapi: 3.1.0
info:
  title: Tamtam Public API
  version: 2.0.0
servers:
  - url: https://api.tamtam.ai/api
security: []
paths:
  /v2/webhook-deliveries:
    get:
      tags:
        - Webhooks
      summary: List webhook deliveries
      description: >-
        What we have tried to push, and what happened. Filter by endpoint and by
        state to answer "what is failing".


        Your endpoint's response **body is never stored** — only the status code
        and a failure reason from a fixed set, since the body comes from an
        address you control and we do not persist what we fetch from it.


        This is a debugging surface, not a second feed. To reconcile everything
        you should have received, walk [List ICP
        signals](/api-reference/icp-signal-watches/list-icp-signals) with its
        cursor.
      operationId: list-webhook-deliveries
      parameters:
        - description: >-
            Target account UUID. Required for staff callers; ignored for
            customer API keys.
          explode: false
          in: query
          name: account_id
          schema:
            description: >-
              Target account UUID. Required for staff callers; ignored for
              customer API keys.
            type: string
        - description: >-
            Only deliveries for this endpoint. Omit for every endpoint on the
            account.
          explode: false
          in: query
          name: webhook_endpoint_id
          schema:
            description: >-
              Only deliveries for this endpoint. Omit for every endpoint on the
              account.
            type: string
        - description: >-
            Only deliveries in this state: pending, delivered, exhausted,
            rejected. Omit for all of them.
          explode: false
          in: query
          name: status
          schema:
            description: >-
              Only deliveries in this state: pending, delivered, exhausted,
              rejected. Omit for all of them.
            examples:
              - exhausted
            type: string
        - description: Maximum deliveries to return.
          explode: false
          in: query
          name: limit
          schema:
            default: 100
            description: Maximum deliveries to return.
            format: int32
            maximum: 500
            minimum: 1
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListWebhookDeliveriesResponseDto'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Error
      security:
        - apikeyAuth: []
        - bearerAuth: []
components:
  schemas:
    ListWebhookDeliveriesResponseDto:
      additionalProperties: false
      properties:
        deliveries:
          description: Most recently queued first.
          items:
            $ref: '#/components/schemas/WebhookDeliveryDto'
          type:
            - array
            - 'null'
      required:
        - deliveries
      type: object
    ErrorModel:
      additionalProperties: false
      properties:
        detail:
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem.
          examples:
            - Property foo is required but is missing.
          type: string
        errors:
          description: Optional list of individual error details
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type:
            - array
            - 'null'
        instance:
          description: >-
            A URI reference that identifies the specific occurrence of the
            problem.
          examples:
            - https://example.com/error-log/abc123
          format: uri
          type: string
        status:
          description: HTTP status code
          examples:
            - 400
          format: int64
          type: integer
        title:
          description: >-
            A short, human-readable summary of the problem type. This value
            should not change between occurrences of the error.
          examples:
            - Bad Request
          type: string
        type:
          default: about:blank
          description: A URI reference to human-readable documentation for the error.
          examples:
            - https://example.com/errors/example
          format: uri
          type: string
      type: object
    WebhookDeliveryDto:
      additionalProperties: false
      properties:
        attempt_count:
          description: How many attempts have been made.
          format: int32
          type: integer
        created_at:
          description: When the delivery was queued.
          format: date-time
          type: string
        delivered_at:
          description: When it succeeded.
          format: date-time
          type: string
        failure_reason:
          description: >-
            Why the last attempt failed, from a fixed set: timeout, dns, tls,
            connection_refused, connection, blocked_destination, redirect,
            http_error. Your endpoint's response body is never stored.
          examples:
            - timeout
          type: string
        icp_signal_event_id:
          description: The event being delivered. The same id you would see on the feed.
          type: string
        id:
          description: Delivery UUID. Matches the delivery_id in the pushed envelope.
          type: string
        last_attempt_at:
          description: When we last tried. Absent before the first attempt.
          format: date-time
          type: string
        next_attempt_at:
          description: >-
            When the next attempt becomes due. Only meaningful while status is
            pending.
          format: date-time
          type: string
        response_status:
          description: HTTP status your endpoint returned. Absent when nothing answered.
          format: int32
          type: integer
        status:
          description: >-
            One of: pending (queued or waiting on a retry), delivered (your
            endpoint answered 2xx), exhausted (out of attempts), rejected
            (answered in a way no retry fixes, or the URL stopped being one we
            will call).
          examples:
            - delivered
          type: string
        webhook_endpoint_id:
          description: Endpoint this delivery is for.
          type: string
      required:
        - id
        - webhook_endpoint_id
        - icp_signal_event_id
        - status
        - attempt_count
        - next_attempt_at
        - created_at
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: >-
            Where the error occurred, e.g. 'body.items[3].tags' or
            'path.thing-id'
          type: string
        message:
          description: Error message text
          type: string
        value:
          description: The value at the given location
      type: object
  securitySchemes:
    apikeyAuth:
      description: Account API key passed in the Authorization header
      in: header
      name: Authorization
      type: apiKey
    bearerAuth:
      description: Bearer JWT obtained via the OAuth 2.1 authorization flow
      scheme: bearer
      type: http

````