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

# List deliveries

> Returns delivery attempts, newest first, using cursor pagination.



## OpenAPI

````yaml api-reference/endl-webhooks-api.json GET /api/v0/webhooks/events
openapi: 3.1.0
info:
  title: Endl Webhooks API
  version: '0'
  description: >-
    Register where your events go, inspect what happened to each delivery, and
    read the PULL feed.


    Every endpoint returns the standard Endl response envelope and requires the
    `webhooks` permission — the PULL feed additionally requires `events`.
servers:
  - url: https://qa-api.endl.xyz
    description: QA
security:
  - apiKey: []
tags:
  - name: Subscriptions
    description: Register and manage the endpoints that receive your events.
  - name: Deliveries
    description: Inspect and retry individual delivery attempts.
  - name: Events
    description: Read events from the PULL feed.
paths:
  /api/v0/webhooks/events:
    get:
      tags:
        - Deliveries
      summary: List deliveries
      description: Returns delivery attempts, newest first, using cursor pagination.
      parameters:
        - name: subscriptionId
          in: query
          schema:
            type: string
            format: uuid
          description: Scope results to one subscription.
        - name: status
          in: query
          schema:
            type: string
          description: >-
            Filter by delivery status. Repeatable —
            `?status=FAILED&status=EXPIRED`.
        - name: types
          in: query
          schema:
            type: string
          description: Filter by event type. Repeatable.
        - name: after
          in: query
          schema:
            type: string
          description: Pagination cursor.
        - name: limit
          in: query
          schema:
            type: integer
            default: 25
            maximum: 100
          description: Page size, maximum 100.
      responses:
        '200':
          description: A page of deliveries.
          content:
            application/json:
              example:
                code: 200
                message: Success
                status: SUCCESS
                data:
                  deliveries:
                    - id: 4d2f6a11-8c73-4b90-9e21-5f0a2c8d1e44
                      eventId: evt_9f1a4c7b2e08
                      eventType: payout.completed
                      subscriptionId: 2b1e8f40-3c9a-4d21-9f7e-6a1c0b5d2e34
                      status: FAILED
                      attemptCount: 5
                      attemptBudget: 5
                errors: []
        '400':
          description: Bad `limit`, bad cursor, bad parameter, or missing permission.
        '401':
          description: Authentication failed.
        '503':
          description: Endl could not verify the credential right now.
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: API-KEY
      description: >-
        Your partner API key. Requires the `webhooks` permission, or `events`
        for the PULL feed.

````