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

# List Webhook Endpoints

> List webhook endpoints configured for your organization and environment.

Returns every non-deleted webhook endpoint owned by the authenticated
organization. Signing secrets are never included.

Use `status`, `consecutive_failures`, `last_success_at`, and `last_failure_at` to
monitor endpoint health.


## OpenAPI

````yaml reference/openapi.json GET /webhooks/endpoints
openapi: 3.0.0
info:
  title: Unifystays API
  description: >-
    One unified hotel API across suppliers. Integrate once, then enable and
    manage suppliers from the Unifystays portal.
  version: '1.0'
  contact: {}
servers:
  - url: https://api-sandbox.unifystays.com
    description: Sandbox
  - url: https://api.unifystays.com
    description: Production
security:
  - x-api-key: []
tags: []
paths:
  /webhooks/endpoints:
    get:
      tags:
        - Webhooks
      summary: List webhook endpoints
      description: >-
        Lists every non-deleted webhook endpoint owned by the authenticated
        organization.
      operationId: WebhookController_listEndpoints
      parameters:
        - name: language
          description: Enter language code(ex. en)
          in: header
          schema: {}
      responses:
        '200':
          description: Webhook endpoints retrieved successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WebhookEndpointListResponseDto'
components:
  schemas:
    WebhookEndpointListResponseDto:
      type: object
      properties:
        data:
          description: Non-deleted webhook endpoints owned by the organization.
          type: array
          items:
            $ref: '#/components/schemas/WebhookEndpointResponseDto'
      required:
        - data
    WebhookEndpointResponseDto:
      type: object
      properties:
        id:
          type: string
          format: uuid
          example: 8b95a9e0-4af3-4c6d-92df-84b64256d27f
          description: Unique webhook endpoint identifier.
        name:
          type: string
          example: Production booking events
          description: Human-readable endpoint name.
        url:
          type: string
          format: uri
          example: https://example.com/webhooks/unifystays
          description: URL that receives signed webhook POST requests.
        status:
          type: string
          enum:
            - ACTIVE
            - PAUSED
            - DISABLED
          example: ACTIVE
          description: >-
            Current endpoint state. Paused and disabled endpoints do not receive
            new deliveries.
        event_types:
          type: array
          example:
            - booking.confirmed
            - booking.cancelled
          description: Normalized event subscriptions for this endpoint.
          items:
            type: string
            enum:
              - booking.created
              - booking.confirmed
              - booking.failed
              - booking.cancellation_requested
              - booking.cancelled
              - booking.cancellation_failed
              - booking.*
        consecutive_failures:
          type: number
          example: 0
          description: >-
            Consecutive delivery failures since the last success or
            reactivation.
        last_success_at:
          type: string
          format: date-time
          nullable: true
          example: '2026-08-08T08:30:00.000Z'
          description: Time of the most recent successful delivery, if any.
        last_failure_at:
          type: string
          format: date-time
          nullable: true
          example: null
          description: Time of the most recent failed delivery, if any.
        disabled_at:
          type: string
          format: date-time
          nullable: true
          example: null
          description: Time the endpoint was disabled, if applicable.
        disabled_reason:
          type: string
          nullable: true
          example: null
          description: Reason the endpoint was disabled, if applicable.
        created_at:
          type: string
          format: date-time
          example: '2026-08-08T08:00:00.000Z'
          description: Endpoint creation time.
        updated_at:
          type: string
          format: date-time
          example: '2026-08-08T08:30:00.000Z'
          description: Time the endpoint was last updated.
      required:
        - id
        - name
        - url
        - status
        - event_types
        - consecutive_failures
        - last_success_at
        - last_failure_at
        - disabled_at
        - disabled_reason
        - created_at
        - updated_at
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key
      description: Environment-specific API key created in the Unifystays portal

````