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

# List Webhook Deliveries

> Returns the authenticated sender's webhook delivery log, newest first.
Use this to audit which events were delivered and to find failed or expired
deliveries to replay. List items omit the large `requestPayload` and
`responseBody` fields — fetch a single delivery to see them.




## OpenAPI

````yaml openapi-v2.yaml GET /sender/webhooks
openapi: 3.0.3
info:
  title: Paycrest Aggregator API
  version: 1.0.0
  description: >
    OpenAPI schema for the Paycrest Aggregator API. This covers sender,
    provider, and general endpoints.
servers:
  - url: https://api.paycrest.io/v2
security: []
tags:
  - name: Sender
    description: Endpoints for senders to create and manage payment orders
  - name: Provider
    description: Endpoints for providers to manage and fulfill orders
  - name: General
    description: General protocol and utility endpoints
paths:
  /sender/webhooks:
    get:
      tags:
        - Sender
      summary: List webhook deliveries
      description: >
        Returns the authenticated sender's webhook delivery log, newest first.

        Use this to audit which events were delivered and to find failed or
        expired

        deliveries to replay. List items omit the large `requestPayload` and

        `responseBody` fields — fetch a single delivery to see them.
      parameters:
        - in: query
          name: status
          schema:
            type: string
            enum:
              - pending
              - success
              - failed
              - expired
          description: Filter by delivery status.
        - in: query
          name: event
          schema:
            type: string
          description: Filter by event name, e.g. `payment_order.settled`.
        - in: query
          name: event_id
          schema:
            type: string
          description: Filter by the underlying event identifier.
        - in: query
          name: order_id
          schema:
            type: string
            format: uuid
          description: Filter to deliveries for a single payment order.
        - in: query
          name: from
          schema:
            type: string
            format: date-time
          description: Only deliveries created at or after this timestamp.
        - in: query
          name: to
          schema:
            type: string
            format: date-time
          description: Only deliveries created at or before this timestamp.
        - in: query
          name: page
          schema:
            type: integer
            default: 1
        - in: query
          name: pageSize
          schema:
            type: integer
            default: 10
      responses:
        '200':
          description: List of webhook deliveries
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                  data:
                    $ref: '#/components/schemas/WebhookDeliveryList'
        '401':
          description: Unauthorized
      security:
        - ApiKeyAuth: []
      servers:
        - url: https://api.paycrest.io/v2
components:
  schemas:
    WebhookDeliveryList:
      type: object
      properties:
        total:
          type: integer
        page:
          type: integer
        pageSize:
          type: integer
        deliveries:
          type: array
          items:
            $ref: '#/components/schemas/WebhookDelivery'
    WebhookDelivery:
      type: object
      description: >
        A single outbound webhook delivery attempt. Returned in list responses

        (the large `requestPayload` and `responseBody` fields are omitted from
        list

        items — fetch a single delivery to see them).
      properties:
        id:
          type: string
          format: uuid
          description: Unique ID of this delivery record.
        event:
          type: string
          enum:
            - payment_order.deposited
            - payment_order.pending
            - payment_order.validated
            - payment_order.settling
            - payment_order.settled
            - payment_order.refunding
            - payment_order.refunded
            - payment_order.expired
          description: The webhook event that was delivered.
        eventId:
          type: string
          description: Identifier of the underlying event (matches the `event_id` filter).
        orderId:
          type: string
          format: uuid
          description: The payment order this delivery relates to, if any.
        status:
          type: string
          enum:
            - pending
            - success
            - failed
            - expired
          description: >
            Delivery status. `pending` — queued or awaiting retry; `success` —
            the

            endpoint returned a 2xx; `failed` — a transport error or non-2xx
            response,

            scheduled for retry; `expired` — gave up after the 24h retry window.
        trigger:
          type: string
          enum:
            - automatic
            - cron_retry
            - manual_sync
            - manual_async
          description: >
            What produced this attempt. `automatic` — first send on the event;

            `cron_retry` — automatic backoff retry; `manual_sync`/`manual_async`
            —

            a sender-initiated retry via the retry endpoint.
        httpStatusCode:
          type: integer
          description: >-
            HTTP status code returned by your endpoint (0 if no response was
            received).
          example: 200
        attemptNumber:
          type: integer
          description: 1-based attempt counter for this delivery.
          example: 1
        destinationUrl:
          type: string
          format: uri
          description: The webhook URL the request was sent to.
        signature:
          type: string
          description: The `X-Paycrest-Signature` (HMAC-SHA256 hex) sent with the request.
        errorMessage:
          type: string
          description: Transport or HTTP error message, if the attempt failed.
        durationMs:
          type: integer
          description: Round-trip duration of the attempt, in milliseconds.
        nextRetryTime:
          type: string
          format: date-time
          description: >-
            When the next automatic retry is scheduled (null once delivered or
            expired).
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: API-Key

````