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

# List Deliveries

> See the delivery history for an endpoint, newest first.

Returns the endpoint, its recent health `incidents` and up to 50 deliveries, newest first.

| Delivery `status` | Meaning |
| - | - |
| `pending` | Waiting for its next attempt. |
| `in_flight` | Being sent now. |
| `accepted` | Your receiver returned `2xx`. |
| `exhausted` | Every retry failed. You can [replay it](https://docs.prava.space/api-reference/webhooks/replay-delivery.md). |
| `cancelled` | The endpoint was deleted before delivery. |

To get the next page, pass `next_cursor` as `cursor`. Treat it as opaque and URL-encode it. It's `null` on the last page. Use [Retrieve a delivery](https://docs.prava.space/api-reference/webhooks/get-delivery.md) for one delivery's attempts.


## OpenAPI

````yaml api-reference/openapi.json GET /v1/webhook-endpoints/{endpointId}/deliveries
openapi: 3.1.0
info:
  title: Prava Payments API
  description: >-
    Server-side REST API for Prava Payments. All requests are authenticated with
    your secret key (sk_test_* in sandbox, sk_live_* in production).
  version: 1.0.0
servers:
  - url: https://sandbox.api.prava.space
    description: Sandbox
  - url: https://api.prava.space
    description: Production
security:
  - bearerAuth: []
paths:
  /v1/webhook-endpoints/{endpointId}/deliveries:
    get:
      tags:
        - Webhooks
      summary: GET /v1/webhook-endpoints/{endpointId}/deliveries
      description: >-
        Gated preview; application and environment are derived from the secret
        key. See the Webhooks guide for delivery and signing contracts.
      parameters:
        - name: endpointId
          in: path
          required: true
          schema:
            type: string
        - name: cursor
          in: query
          schema:
            type: string
          description: >-
            Return next_cursor unchanged. Events starts at 0; deliveries starts
            with no cursor.
      responses:
        '200':
          description: >-
            Retained delivery history with public endpoint status and scoped
            incident summaries; no signing or encrypted secret material.
          content:
            application/json:
              schema:
                type: object
                required:
                  - endpoint
                  - incidents
                  - deliveries
                  - next_cursor
                properties:
                  endpoint:
                    $ref: '#/components/schemas/WebhookEndpoint'
                  incidents:
                    type: array
                    maxItems: 20
                    items:
                      $ref: '#/components/schemas/WebhookIncident'
                    description: Recent health incidents, newest first.
                  deliveries:
                    type: array
                    maxItems: 50
                    items:
                      $ref: '#/components/schemas/WebhookDeliverySummary'
                    description: Newest first.
                  next_cursor:
                    type:
                      - string
                      - 'null'
                    description: >-
                      Pass as `cursor` for the next page. `null` on the last
                      page.
        '400':
          description: Invalid input or cursor
        '404':
          description: Resource not found in this application
        '409':
          description: Verification, idempotency, or endpoint state conflict
        '503':
          description: Preview disabled or temporarily unavailable
components:
  schemas:
    WebhookEndpoint:
      type: object
      required:
        - id
        - owner_id
        - environment
        - name
        - url
        - events
        - revision
        - enabled
        - verified_at
        - deleted_at
        - created_at
        - schema_version
        - consecutive_failures
        - circuit_until
        - blocked_reason
      properties:
        id:
          type: string
          description: Endpoint ID, starting with `whe_`.
          examples:
            - whe_0123456789abcdef0123456789abcdef
        owner_id:
          type: string
          description: Your application's account ID, starting with `ma_`.
        environment:
          type: string
          enum:
            - sandbox
            - production
        name:
          type: string
          minLength: 1
          maxLength: 80
        url:
          type: string
          format: uri
          description: The HTTPS URL that receives events.
        events:
          type: array
          items:
            $ref: '#/components/schemas/WebhookEventType'
          description: Event types sent to this endpoint.
        revision:
          type: string
          description: Increases by one each time the URL changes. Returned as a string.
        enabled:
          type: boolean
          description: Whether new events are delivered. New endpoints start with `false`.
        verified_at:
          type:
            - string
            - 'null'
          format: date-time
          description: When verification succeeded. Cleared when the URL changes.
        deleted_at:
          type:
            - string
            - 'null'
          format: date-time
          description: '`null` for active endpoints.'
          examples:
            - null
        created_at:
          type: string
          format: date-time
        schema_version:
          type: string
          description: Payload schema version sent to this endpoint.
          examples:
            - '2026-10-08'
        consecutive_failures:
          type: integer
          minimum: 0
          description: Failed deliveries in a row. Resets after a delivery is accepted.
          examples:
            - 0
        circuit_until:
          type:
            - string
            - 'null'
          format: date-time
          description: Deliveries are held until this time after repeated failures.
          examples:
            - null
        blocked_reason:
          type:
            - string
            - 'null'
          enum:
            - RECEIVER_UNACKNOWLEDGED
            - DELIVERY_FAILURE_LIMIT
            - HTTP_GONE
            - DESTINATION_BLOCKED
            - null
          description: >-
            Why Prava paused deliveries, or `null`. See [Endpoint health
            reasons](/webhooks/delivery#endpoint-health-reasons).
          examples:
            - null
    WebhookIncident:
      type: object
      required:
        - id
        - reason
        - delivery_id
        - opened_at
        - resolved_at
      properties:
        id:
          type: string
          description: Incident ID, starting with `whi_`.
        reason:
          type: string
          enum:
            - RECEIVER_UNACKNOWLEDGED
            - ENDPOINT_UNHEALTHY
            - HTTP_GONE
            - DESTINATION_BLOCKED
            - DELIVERY_EXHAUSTED
        delivery_id:
          type:
            - string
            - 'null'
          description: The delivery that ran out of retries, for `DELIVERY_EXHAUSTED`.
        opened_at:
          type: string
          format: date-time
        resolved_at:
          type:
            - string
            - 'null'
          format: date-time
    WebhookDeliverySummary:
      type: object
      required:
        - id
        - event_id
        - type
        - status
        - attempt_count
        - next_attempt_at
        - accepted_at
        - created_at
      properties:
        id:
          type: string
          description: Delivery ID, starting with `whd_`.
        event_id:
          type: string
        type:
          $ref: '#/components/schemas/WebhookEventType'
        status:
          type: string
          enum:
            - pending
            - in_flight
            - accepted
            - exhausted
            - cancelled
          description: >-
            `exhausted` means every retry failed; `cancelled` means the endpoint
            was deleted before delivery.
        attempt_count:
          type: integer
          minimum: 0
          maximum: 9
        next_attempt_at:
          type: string
          format: date-time
        accepted_at:
          type:
            - string
            - 'null'
          format: date-time
        created_at:
          type: string
          format: date-time
    WebhookEventType:
      type: string
      enum:
        - payment.credentials_ready
        - payment.succeeded
        - payment.failed
        - card_enrollment.completed
        - card_enrollment.failed
        - card_enrollment.cancelled
        - card_enrollment.expired
        - mandate.created
        - mandate.creation_failed
        - mandate.creation_cancelled
        - mandate.creation_expired
        - mandate.paused
        - mandate.resumed
        - mandate.cancelled
        - mandate.expired
        - quote.request_failed
      description: A webhook event type.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Your secret key: sk_test_* (sandbox) or sk_live_* (production).'

````

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