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

# GET /webhooks/{id}/deliveries

> If this request returns 503, stop the workflow and retry later when instructed, or contact support with its requestId. Delivery history with status and attempts. No signing secrets or receiver response bodies. Terminal history retained for 30 days. Required permissions: webhooks.read. Use Postman or your backend. Keep your API key private; do not enter it in this public documentation page.

Read delivery status, event IDs, attempts and safe failure codes. Required permission: `webhooks.read`. Follow `page.nextCursor` using `after` for another page. Terminal history is retained for 30 days; signing secrets and receiver response bodies are not included.

> [!NOTE]
>
> If this request returns `503`, stop the workflow and retry later when instructed, or contact support with the response `requestId`. Use your Platform key privately in Postman or your backend, not this page. See [delivery handling and retry guidance](https://docs.layarva.com/developers/platform-webhooks.md#step-5-handle-retries-safely).


## OpenAPI

````yaml api/platform-workspace.openapi.json GET /webhooks/{id}/deliveries
openapi: 3.1.0
info:
  title: Layarva Platform / Workspace API
  version: 1.1.0
  description: >-
    Manage Library, Playlists, Channels, Locations, Edges, Screens and
    Schedules. Use a Platform key, not a Widget key. See
    https://docs.layarva.com/developers/platform-quickstart. Upload supported
    files, export eligible offline packages and receive signed Platform
    webhooks. Permissions, plan limits and publishing rules apply. If a request
    returns 503, stop that workflow and contact support with its requestId.
servers:
  - url: https://api.layarva.com/api/platform/v1/workspaces/{workspaceId}
    variables:
      workspaceId:
        default: workspace_example
security:
  - PlatformBearer: []
paths:
  /webhooks/{id}/deliveries:
    get:
      tags:
        - webhooks
      summary: GET /webhooks/{id}/deliveries
      description: >-
        If this request returns 503, stop the workflow and retry later when
        instructed, or contact support with its requestId. Delivery history with
        status and attempts. No signing secrets or receiver response bodies.
        Terminal history retained for 30 days. Required permissions:
        webhooks.read. Use Postman or your backend. Keep your API key private;
        do not enter it in this public documentation page.
      operationId: get__webhooks_id_deliveries
      parameters:
        - name: id
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/Id'
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 50
          description: Default 50; 1–100 decimal string; repeat/unknown parameters refused.
        - name: after
          in: query
          schema:
            type: string
            pattern: ^[A-Za-z0-9_-]{1,100}$
          description: >-
            Opaque prior nextCursor; ID-ascending keyset pagination, not a
            timestamp.
      responses:
        '200':
          description: Safe live-authorized result
          headers:
            X-Request-Id:
              schema:
                type: string
            Cache-Control:
              schema:
                const: private, no-store
            X-RateLimit-Limit:
              schema:
                type: string
            X-RateLimit-Remaining:
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/WebhookDelivery'
                  page:
                    $ref: '#/components/schemas/Page'
                required:
                  - data
                  - page
                additionalProperties: false
        default:
          description: >-
            Error with code, message and requestId. Follow Retry-After when
            present. Contact support with the requestId if the problem
            continues.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          headers:
            X-Request-Id:
              schema:
                type: string
            Retry-After:
              schema:
                type: string
components:
  schemas:
    Id:
      $schema: https://json-schema.org/draft/2020-12/schema
      type: string
      pattern: ^[A-Za-z0-9_-]{1,100}$
    WebhookDelivery:
      type: object
      properties:
        id:
          type: string
        eventId:
          type: string
        event:
          type: string
        status:
          enum:
            - PENDING
            - SENDING
            - DELIVERED
            - FAILED
            - CANCELLED
        attempt:
          type: number
        statusCode:
          anyOf:
            - type: number
            - type: 'null'
        failureCode:
          anyOf:
            - type: string
            - type: 'null'
        createdAt:
          type: string
          format: date-time
        completedAt:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
      required:
        - id
        - eventId
        - event
        - status
        - attempt
        - statusCode
        - failureCode
        - createdAt
        - completedAt
      additionalProperties: false
    Page:
      type: object
      properties:
        limit:
          type: integer
          minimum: 1
          maximum: 100
        nextCursor:
          anyOf:
            - type: string
            - type: 'null'
      required:
        - limit
        - nextCursor
      additionalProperties: false
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            requestId:
              type: string
          required:
            - code
            - message
            - requestId
          additionalProperties: false
      required:
        - error
      additionalProperties: false
  securitySchemes:
    PlatformBearer:
      type: http
      scheme: bearer
      bearerFormat: lv_platform_<43 base64url characters>
      description: >-
        Platform API key for one workspace. Create it in Settings with an expiry
        date or Never expire. Keep it private; use it from Postman or your
        backend, not browser code. Widget keys are not accepted.

````

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