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

# List delivery attempts to an endpoint

> Lists every delivery attempt made to one endpoint across the organization's events, newest first, each with its outcome, the HTTP status the endpoint returned, its try number and the event it delivered. Filter by outcome (status) or event type. Pages the same way as the delivery log. A missing or wrong-organization endpoint id returns 404.

<span class="api-role api-role-admin" title="Admins only.">Minimum role required: Admin</span>


## OpenAPI

````yaml /api-reference/openapi-backend.json get /webhooks/endpoints/{endpoint_id}/attempts
openapi: 3.1.0
info:
  description: Axilio backend HTTP API.
  title: Axilio API
  version: 0.107.0
servers:
  - url: https://api.axilio.ai/api/v1
    description: Production
security: []
tags:
  - name: API Keys
  - name: Billing
  - name: Files
  - name: Organization
  - name: Phones
  - name: Runs
  - name: Skill
  - name: Usage
  - name: Webhooks
  - name: Workflows
paths:
  /webhooks/endpoints/{endpoint_id}/attempts:
    get:
      tags:
        - Webhooks
      summary: List delivery attempts to an endpoint
      description: >-
        Lists every delivery attempt made to one endpoint across the
        organization's events, newest first, each with its outcome, the HTTP
        status the endpoint returned, its try number and the event it delivered.
        Filter by outcome (status) or event type. Pages the same way as the
        delivery log. A missing or wrong-organization endpoint id returns 404.
      operationId: webhooks_list_endpoint_attempts
      parameters:
        - description: Endpoint identifier.
          in: path
          name: endpoint_id
          required: true
          schema:
            description: Endpoint identifier.
            minLength: 1
            type: string
        - description: Page size.
          explode: false
          in: query
          name: limit
          schema:
            default: 50
            description: Page size.
            format: int64
            maximum: 200
            minimum: 1
            type: integer
        - description: >-
            Opaque cursor from a previous page's next_cursor. Omit for the first
            page.
          explode: false
          in: query
          name: cursor
          schema:
            description: >-
              Opaque cursor from a previous page's next_cursor. Omit for the
              first page.
            maxLength: 512
            type: string
        - description: Keep only attempts with this outcome. Omit for both.
          explode: false
          in: query
          name: status
          schema:
            description: Keep only attempts with this outcome. Omit for both.
            enum:
              - success
              - failed
            type: string
        - description: Keep only attempts of events of this type. Omit for all types.
          explode: false
          in: query
          name: event_type
          schema:
            description: Keep only attempts of events of this type. Omit for all types.
            maxLength: 255
            type: string
        - description: Only attempts that completed at or after this time (RFC 3339).
          explode: false
          in: query
          name: delivered_after
          schema:
            description: Only attempts that completed at or after this time (RFC 3339).
            format: date-time
            type: string
        - description: Only attempts that completed at or before this time (RFC 3339).
          explode: false
          in: query
          name: delivered_before
          schema:
            description: Only attempts that completed at or before this time (RFC 3339).
            format: date-time
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookEndpointAttemptListResponse'
          description: OK
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/V2ErrorModel'
          description: Not Found
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/V2ErrorModel'
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/V2ErrorModel'
          description: Internal Server Error
      security:
        - apiKeyAuth: []
components:
  schemas:
    WebhookEndpointAttemptListResponse:
      additionalProperties: false
      description: One page of the delivery attempts made to one endpoint.
      properties:
        attempts:
          description: Delivery attempts on this page, newest first.
          items:
            $ref: '#/components/schemas/WebhookEndpointAttempt'
          type:
            - array
            - 'null'
        next_cursor:
          description: >-
            Opaque cursor for the next page (pass as the cursor query
            parameter). Null when this is the last page.
          type:
            - string
            - 'null'
      required:
        - attempts
        - next_cursor
      type: object
    V2ErrorModel:
      additionalProperties: false
      description: >-
        Error response, following RFC 9457 (Problem Details for HTTP APIs).
        Returned with a application/problem+json content type.
      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/V2ErrorDetail'
          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
    WebhookEndpointAttempt:
      additionalProperties: false
      description: One delivery attempt to an endpoint, with the event it delivered.
      properties:
        attempt_number:
          description: >-
            1-based position of this try among the event's tries to the
            endpoint: 1 is the first delivery, 2 and up are retries or replays.
          format: int64
          type: integer
        delivered_at:
          description: Timestamp when the attempt completed, null if pending.
          format: date-time
          type: string
        event_id:
          description: Event the attempt delivered.
          type: string
        event_published_at:
          description: Timestamp when the delivered event was published.
          format: date-time
          type: string
        event_type:
          description: Type of the event the attempt delivered.
          type: string
        id:
          description: Attempt identifier.
          type: string
        manual:
          description: >-
            True for an attempt driven by an explicit replay rather than the
            automatic retry schedule.
          type: boolean
        response_status:
          description: HTTP status the endpoint returned, or 0 if it never answered.
          format: int64
          type: integer
        status:
          description: >-
            Attempt outcome: success (endpoint acknowledged with a 2xx) or
            failed (non-2xx or no answer).
          enum:
            - success
            - failed
          type: string
      required:
        - id
        - status
        - response_status
        - manual
        - attempt_number
        - event_id
        - event_type
      type: object
    V2ErrorDetail:
      additionalProperties: false
      description: >-
        One specific problem within an error response, locating the offending
        part of the request.
      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: Customer API key (axl_ prefix).
      in: header
      name: X-Axilio-Api-Key
      type: apiKey

````

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