# List webhooks

Retrieves a paginated list of all webhooks currently registered to receive event notifications. Supports offset and limit for pagination. Webhooks include metadata about creation, update, and suspension state.


Endpoint: GET /webhooks
Version: 1.0.0
Security: basicAuth

## Query parameters:

  - `offset` (integer)
    Pagination offset

  - `limit` (integer)
    Number of webhooks to return
    Example: 10

## Response 200 fields (application/json):

  - `http` (integer, required)
    Example: 200

  - `offset` (integer, required)
    Example: 10

  - `limit` (integer, required)
    Example: 10

  - `total_webhooks` (string, required)
    Example: "44"

  - `next` (string)
    Example: "https://api.signable.co.uk/v1/webhooks?offset=10&limit=10"

  - `webhooks` (array, required)

  - `webhooks.webhook_id` (string, required)
    Unique identifier of the webhook
    Example: "132223"

  - `webhooks.webhook_url` (string, required)
    The URL to which webhook events are sent
    Example: "https://example.com"

  - `webhooks.webhook_type` (string, required)
    The type of event the webhook listens for
    Enum: "send-envelope", "signed-envelope", "cancelled-envelope", "rejected-envelope", "bounced-envelope", "add-user", "add-contact", "opened-envelope", "add-template", "all", "signed-envelope-complete", "verify-envelope-widget", "signed-envelope-widget", "send-envelope-failed"

  - `webhooks.webhook_created` (string, required)
    Timestamp when the webhook was created
    Example: "2025-06-23T17:15:01+0000"

  - `webhooks.webhook_updated` (any, required)
    When the webhook was last updated

  - `webhooks.webhook_suspended` (any, required)
    When the webhook was suspended (or null if active)