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

# Get webhook deliveries

> Get delivery history for a webhook endpoint



## OpenAPI

````yaml /swagger.json get /v1/apps/{app_id}/webhooks/{id}/deliveries
openapi: 3.0.1
info:
  title: Scute API
  version: v1
  description: API for managing users in Scute applications
servers:
  - url: https://{defaultHost}
    variables:
      defaultHost:
        default: api.scute.io
  - url: http://localhost:3333
    description: Development server
security:
  - apiSecret: []
    userAccess: []
paths:
  /v1/apps/{app_id}/webhooks/{id}/deliveries:
    parameters:
      - name: app_id
        in: path
        description: Application ID
        required: true
        schema:
          type: string
      - name: id
        in: path
        description: Webhook endpoint ID
        required: true
        schema:
          type: string
    get:
      tags:
        - Webhooks
      summary: Get webhook deliveries
      description: Get delivery history for a webhook endpoint
      operationId: getWebhookDeliveries
      parameters:
        - name: page
          in: query
          required: false
          description: Page number for pagination
          schema:
            type: integer
        - name: per_page
          in: query
          required: false
          description: 'Number of items per page (max: 100)'
          schema:
            type: integer
        - name: status
          in: query
          required: false
          description: |-
            Filter by delivery status:
             * `pending` 
             * `processing` 
             * `delivered` 
             * `failed` 
             
          schema:
            type: string
            enum:
              - pending
              - processing
              - delivered
              - failed
      responses:
        '200':
          description: successful
          content:
            application/json:
              schema:
                type: object
                properties:
                  deliveries:
                    type: array
                    items:
                      $ref: '#/components/schemas/WebhookDelivery'
                  pagination:
                    type: object
                    properties:
                      current_page:
                        type: integer
                        description: Current page number
                      total_pages:
                        type: integer
                        description: Total number of pages
                      total_count:
                        type: integer
                        description: Total number of deliveries
                      per_page:
                        type: integer
                        description: Items per page
        '404':
          description: not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message
                  error_code:
                    type: string
                    description: Error code
      security:
        - apiSecret: []
          userAccess: []
components:
  schemas:
    WebhookDelivery:
      type: object
      properties:
        id:
          type: string
          description: Webhook delivery ID
        webhook_endpoint_id:
          type: string
          description: Webhook endpoint ID
        event_id:
          type: string
          description: Event ID that triggered this delivery
        status:
          type: string
          enum:
            - pending
            - processing
            - delivered
            - failed
          description: Delivery status
        retry_count:
          type: integer
          minimum: 0
          description: Number of retry attempts made
          example: 0
        signature:
          type: string
          description: HMAC signature for payload verification
          example: t=1640995200,v1=a2114d57b48eac39b9ad189dd8316235...
        response_status:
          type: integer
          nullable: true
          description: HTTP response status code from the webhook endpoint
          example: 200
        response_body:
          type: string
          nullable: true
          description: Response body from the webhook endpoint (truncated if large)
          example: OK
        failure_reason:
          type: string
          nullable: true
          description: Reason for failure if delivery failed
          example: Connection timeout
        payload:
          type: object
          description: JSON payload sent to the webhook endpoint
          properties:
            id:
              type: string
              description: Delivery ID
            created_at:
              type: string
              format: date-time
              description: Delivery timestamp
            event_type:
              type: string
              description: Event type
              example: user.created
            app_id:
              type: string
              description: Application ID
            data:
              type: object
              description: Event data
            api_version:
              type: string
              description: API version
              example: v1
        created_at:
          type: string
          format: date-time
          description: Creation timestamp
        updated_at:
          type: string
          format: date-time
          description: Last update timestamp
      required:
        - id
        - webhook_endpoint_id
        - event_id
        - status
        - retry_count
        - signature
        - payload
  securitySchemes:
    apiSecret:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: API Secret token
    userAccess:
      type: apiKey
      name: X-Authorization
      in: header
      description: User Access token

````