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

# List deliveries for an endpoint

> Delivery log for one endpoint, newest first, kept for 30 days. Filter with status to find failed deliveries to replay.



## OpenAPI

````yaml /openapi/openapi.json get /v1/webhooks/{id}/deliveries
openapi: 3.1.0
info:
  contact:
    name: PrintEasy
    url: https://docs.printeasy.adfinite.com
  description: >-
    Cloud printing API: send PDFs and raw jobs to printers attached to computers
    running the PrintEasy agent.
  title: PrintEasy API
  version: 1.0.0
servers:
  - description: Production
    url: https://api.printeasy.adfinite.com
security:
  - ApiKeyAuth: []
  - BasicAuth: []
tags:
  - description: Who you are, your plan and usage
    name: Account
  - description: Machines running the PrintEasy agent
    name: Computers
  - description: Printers reported by agents
    name: Printers
  - description: Submit and track print jobs
    name: Print jobs
  - description: Signed event delivery to your HTTPS endpoints
    name: Webhooks
  - description: Cursor based event feed
    name: Events
  - description: Prints used this period
    name: Usage
paths:
  /v1/webhooks/{id}/deliveries:
    get:
      tags:
        - Webhooks
      summary: List deliveries for an endpoint
      description: >-
        Delivery log for one endpoint, newest first, kept for 30 days. Filter
        with status to find failed deliveries to replay.
      operationId: listWebhookDeliveries
      parameters:
        - in: path
          name: id
          required: true
          schema:
            format: uuid
            type: string
        - in: query
          name: limit
          required: false
          schema:
            default: 25
            maximum: 100
            minimum: 1
            type: integer
        - description: 'Cursor: the nextCursor of the previous page'
          in: query
          name: after
          required: false
          schema:
            description: 'Cursor: the nextCursor of the previous page'
            format: uuid
            type: string
        - description: desc is newest first; asc is oldest first and suits polling
          in: query
          name: dir
          required: false
          schema:
            default: desc
            description: desc is newest first; asc is oldest first and suits polling
            enum:
              - asc
              - desc
            type: string
        - in: query
          name: status
          required: false
          schema:
            enum:
              - pending
              - retrying
              - succeeded
              - failed
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  data:
                    items:
                      $ref: '#/components/schemas/WebhookDelivery'
                    type: array
                  hasMore:
                    type: boolean
                  nextCursor:
                    type:
                      - string
                      - 'null'
                required:
                  - data
                  - hasMore
                  - nextCursor
                type: object
          description: A page of deliveries
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Invalid request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Missing or invalid API key or session
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: The key scope or member role does not allow this
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: Not found in this organization and mode
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          description: >-
            Rate limit or test mode cap reached; retry after the Retry-After
            header
      security:
        - ApiKeyAuth: []
        - BasicAuth: []
components:
  schemas:
    WebhookDelivery:
      properties:
        attempt:
          description: Sends made so far, 0 before the first
          type: integer
        createdAt:
          format: date-time
          type: string
        deliveredAt:
          format: date-time
          type:
            - string
            - 'null'
        endpointId:
          format: uuid
          type: string
        eventId:
          description: Also sent as the webhook-id header
          format: uuid
          type: string
        eventType:
          enum:
            - printjob.queued
            - printjob.sent
            - printjob.received
            - printjob.printing
            - printjob.done
            - printjob.error
            - printjob.cancelled
            - printjob.expired
            - computer.online
            - computer.offline
            - printer.added
            - printer.removed
            - printer.online
            - printer.offline
            - printer.updated
          example: printjob.done
          type: string
        id:
          format: uuid
          type: string
        nextAttemptAt:
          format: date-time
          type:
            - string
            - 'null'
        payload:
          additionalProperties: {}
          description: The exact envelope sent as the request body
          type: object
        responseBodyExcerpt:
          description: >-
            First 2,048 characters of the last response body, or the network
            error
          type:
            - string
            - 'null'
        responseCode:
          description: HTTP status of the last attempt; null when it got no response
          type:
            - integer
            - 'null'
        status:
          enum:
            - pending
            - retrying
            - succeeded
            - failed
          type: string
      required:
        - id
        - endpointId
        - eventId
        - eventType
        - payload
        - attempt
        - status
        - responseCode
        - responseBodyExcerpt
        - nextAttemptAt
        - deliveredAt
        - createdAt
      type: object
    Error:
      description: >-
        Every error response uses this envelope; code is stable, message is for
        humans.
      properties:
        error:
          properties:
            code:
              example: not_found
              type: string
            message:
              example: Printer not found
              type: string
            request_id:
              example: 4f9c2a7e-1b3d-4c5e-8f6a-0b1c2d3e4f5a
              type: string
          required:
            - code
            - message
            - request_id
          type: object
      required:
        - error
      type: object
  securitySchemes:
    ApiKeyAuth:
      bearerFormat: pe_live_ or pe_test_ key
      description: >-
        Send `Authorization: Bearer <API key>`. Use a pe_test_ key in the
        playground; it only reaches virtual test printers.
      scheme: bearer
      type: http
      x-default: pe_test_REPLACE_WITH_YOUR_TEST_KEY
    BasicAuth:
      description: >-
        PrintNode compatible: put the API key in the username with an empty
        password
      scheme: basic
      type: http

````

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