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

# List Delivery Attempts

> Returns one row per HTTP attempt made against this subscription's endpoint, newest first, so a failing integration can be diagnosed without asking support. Retries appear as separate rows sharing a `source_event_id`, numbered by `attempt`.

`error` carries the returned status or the transport error's class and message. The response body your endpoint returned is never stored or returned, and neither is the signing secret or the delivered payload.

Scoped to the calling org: a subscription belonging to another org is a 404, and a deleted subscription keeps its history.

**Error codes**

| `error.code` | HTTP | Cause | What to do |
| --- | --- | --- | --- |
| `not_found` | 422 | No subscription with this id exists in the calling org. | Check the id; a deleted subscription is never returned. |



## OpenAPI

````yaml https://api.monaco.com/openapi.json get /v1/webhooks/subscriptions/{subscription_id}/deliveries
openapi: 3.1.0
info:
  title: Monaco Public API
  description: Public API for Monaco
  version: 1.0.0
servers:
  - url: https://api.monaco.com
security: []
paths:
  /v1/webhooks/subscriptions/{subscription_id}/deliveries:
    get:
      tags:
        - Webhooks
      summary: List Delivery Attempts
      description: >-
        Returns one row per HTTP attempt made against this subscription's
        endpoint, newest first, so a failing integration can be diagnosed
        without asking support. Retries appear as separate rows sharing a
        `source_event_id`, numbered by `attempt`.


        `error` carries the returned status or the transport error's class and
        message. The response body your endpoint returned is never stored or
        returned, and neither is the signing secret or the delivered payload.


        Scoped to the calling org: a subscription belonging to another org is a
        404, and a deleted subscription keeps its history.


        **Error codes**


        | `error.code` | HTTP | Cause | What to do |

        | --- | --- | --- | --- |

        | `not_found` | 422 | No subscription with this id exists in the calling
        org. | Check the id; a deleted subscription is never returned. |
      operationId: list_webhook_delivery_attempts
      parameters:
        - name: subscription_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Subscription Id
        - name: page
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            description: Page number (1-indexed)
            default: 1
            title: Page
          description: Page number (1-indexed)
        - name: page_size
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            description: Attempts per page
            default: 25
            title: Page Size
          description: Attempts per page
        - name: status
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/WebhookDeliveryStatus'
              - type: 'null'
            description: Return only attempts with this status
            title: Status
          description: Return only attempts with this status
        - name: source_event_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Return only attempts that delivered this envelope id
            title: Source Event Id
          description: Return only attempts that delivered this envelope id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/PublicListResponse_WebhookDeliveryAttemptResponse_
        4XX:
          description: Client error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicErrorResponse'
components:
  schemas:
    WebhookDeliveryStatus:
      type: string
      enum:
        - succeeded
        - failed
      title: WebhookDeliveryStatus
    PublicListResponse_WebhookDeliveryAttemptResponse_:
      properties:
        data:
          items:
            $ref: '#/components/schemas/WebhookDeliveryAttemptResponse'
          type: array
          title: Data
        pagination:
          $ref: '#/components/schemas/PaginationInfo'
        meta:
          $ref: '#/components/schemas/ResponseMeta'
      type: object
      required:
        - data
        - pagination
      title: PublicListResponse[WebhookDeliveryAttemptResponse]
    PublicErrorResponse:
      properties:
        error:
          $ref: '#/components/schemas/ErrorDetail'
      type: object
      required:
        - error
      title: PublicErrorResponse
    WebhookDeliveryAttemptResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
          description: Identifier of this attempt
        subscription_id:
          type: string
          format: uuid
          title: Subscription Id
        source_event_id:
          type: string
          title: Source Event Id
          description: The envelope `id` this attempt delivered; equal across its retries
          examples:
            - 01994f2c-7a10-7b3e-9d21-6f0a5c8e1234
        trigger_key:
          type: string
          title: Trigger Key
          examples:
            - deal.stage_changed
        attempt:
          type: integer
          title: Attempt
          description: 1 for the first attempt, then 2, 3 and 4 for the retries
          examples:
            - 1
        status:
          type: string
          title: Status
          description: '`succeeded` or `failed`'
          examples:
            - failed
        response_code:
          anyOf:
            - type: integer
            - type: 'null'
          title: Response Code
          description: >-
            HTTP status the endpoint returned, or null if no response was
            received
          examples:
            - 404
        duration_ms:
          type: integer
          title: Duration Ms
          description: Wall time of the attempt in milliseconds
          examples:
            - 184
        error:
          anyOf:
            - type: string
            - type: 'null'
          title: Error
          description: >-
            Why the attempt failed: the returned status, or the transport
            error's class and message. Never contains the response body.
          examples:
            - Endpoint returned HTTP 404
        created_at:
          type: string
          format: date-time
          title: Created At
      type: object
      required:
        - id
        - subscription_id
        - source_event_id
        - trigger_key
        - attempt
        - status
        - duration_ms
        - created_at
      title: WebhookDeliveryAttemptResponse
    PaginationInfo:
      properties:
        page:
          type: integer
          title: Page
          description: Current page number
          examples:
            - 1
        page_size:
          type: integer
          title: Page Size
          description: Number of results per page
          examples:
            - 25
        total_count:
          type: integer
          title: Total Count
          description: Total number of matching records
          examples:
            - 142
        total_pages:
          type: integer
          title: Total Pages
          description: Total number of pages
          examples:
            - 6
      type: object
      required:
        - page
        - page_size
        - total_count
        - total_pages
      title: PaginationInfo
    ResponseMeta:
      properties:
        timestamp:
          type: string
          format: date-time
          title: Timestamp
          description: Server timestamp of the response
      type: object
      title: ResponseMeta
    ErrorDetail:
      properties:
        code:
          type: string
          title: Code
          description: Machine-readable error code
          examples:
            - not_found
        message:
          type: string
          title: Message
          description: Human-readable error message
          examples:
            - Resource not found
      type: object
      required:
        - code
        - message
      title: ErrorDetail

````

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