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

# List subscriptions

> Returns every webhook subscription configured for the authenticated paywall. Filter by active status with the `status` query parameter.




## OpenAPI

````yaml GET /webhooks/subscriptions
openapi: 3.1.0
info:
  title: Paywalls.ai API
  description: >
    The Paywalls.ai API enables developers to integrate monetization and access
    control for OpenAI-compatible LLMs.


    This proxy service supports multiple pricing strategies—including
    per-request, token-based, and subscription models—while maintaining full
    compatibility with the OpenAI API format.


    Requests are automatically checked for user authorization and balance. If
    the user is not connected to the paywall, or lacks sufficient balance, the
    API will return actionable links for onboarding or top-up.


    Use this API to monetize your AI-powered apps and services with minimal
    effort.


    Visit [paywalls.ai](https://docs.paywalls.ai) for full documentation and
    setup guides.
  version: 1.0.0
servers:
  - url: https://api.paywalls.ai/v1
    description: Primary production server
security:
  - ApiKeyAuth: []
tags:
  - name: Chat
    description: >
      OpenAI-compatible chat completion endpoint that enforces paywall logic
      before proxying the request to a model provider.


      Automatically checks user connection, balance, and performs charging.
      Supports streaming and non-streaming completions.
  - name: Models
    description: >
      Retrieve metadata and pricing information about the LLM models supported
      by the proxy.


      Includes prompt and completion pricing, per-request costs, and display
      details for UI integration.
  - name: User
    description: >
      Endpoints for managing user sessions, balance, and charging status.


      Includes functionality for connecting to or disconnecting from the
      paywall, checking balance, initiating top-ups, and issuing manual charges.
  - name: Webhooks
    description: >
      Manage webhook subscriptions and inspect delivery activity for your
      paywall integrations.
paths:
  /webhooks/subscriptions:
    get:
      tags:
        - Webhooks
      summary: List webhook subscriptions
      description: >
        Returns every webhook subscription configured for the authenticated
        paywall. Filter by active status with the `status` query parameter.
      parameters:
        - in: query
          name: status
          required: false
          description: Filter results by subscription status.
          schema:
            type: string
            enum:
              - active
              - inactive
      responses:
        '200':
          description: A list of webhook subscriptions.
          content:
            application/json:
              schema:
                type: object
                properties:
                  subscriptions:
                    type: array
                    items:
                      $ref: '#/components/schemas/WebhookSubscription'
                required:
                  - subscriptions
components:
  schemas:
    WebhookSubscription:
      type: object
      description: Configuration for a webhook endpoint that receives paywall events.
      properties:
        id:
          type: string
          description: Unique identifier for the subscription.
        paywallId:
          type: string
          description: Paywall identifier that owns this webhook.
        url:
          type: string
          format: uri
          description: HTTPS destination for webhook deliveries.
        events:
          type: array
          description: List of event keys (or `*`) that trigger deliveries.
          items:
            type: string
        isActive:
          type: boolean
          description: Indicates whether deliveries are attempted.
        description:
          type: string
          description: Optional human-readable label for the subscription.
        customHeaders:
          type: object
          additionalProperties:
            type: string
          description: Optional static headers included with every delivery.
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
        createdBy:
          type: string
          description: Identifier of the paywall owner that created the subscription.
        consecutiveFailures:
          type: integer
          description: Number of consecutive failed delivery attempts.
        lastDeliveredAt:
          type: string
          format: date-time
          description: Timestamp of the most recent successful delivery.
        secretSuffix:
          type: string
          description: Last six characters of the signing secret for display purposes.
        secret:
          type: string
          description: Full signing secret, only returned right after creation.
      required:
        - id
        - paywallId
        - url
        - events
        - isActive
        - createdAt
        - updatedAt
        - secretSuffix
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer

````