# List webhook endpoints

Returns a list of all configured webhook endpoints for the merchant account.

Endpoint: GET /webhooks
Version: V5
Security: bearerAuth, basicAuth

## Security:

  - `bearerAuth` (unknown)
    http bearer JWT

  - `basicAuth` (unknown)
    http basic

## Query parameters:

  - `limit` (integer)
    Limit the number of webhook endpoints returned.

  - `page` (string)
    Specify the page of webhook endpoints returned.

## Response 200:

  - `200` (unknown)
    An object with an array of results containing up to the limit. If no subscriptions are found, the results array will be empty.

## Response 200 fields (application/json):

  - `count` (integer)
    Total number of webhook endpoint subscriptions
    Example: 3

  - `page` (integer)
    Current page number
    Example: 1

  - `limit` (integer)
    Number of results per page
    Example: 25

  - `results` (array)
    Array of webhook endpoint objects. Each object represents one endpoint-topic subscription. If an endpoint is subscribed to multiple topics, it will appear multiple times in the array.

  - `results.id` (string)
    Unique identifier for the webhook endpoint
    Example: whe_abc123def456

  - `results.merchant_id` (string)
    The merchant ID associated with this webhook endpoint
    Example: mer_xyz789

  - `results.endpoint_url` (string)
    The HTTPS URL where webhook events will be sent
    Example: https://example.com/webhooks/resolve

  - `results.topic` (object)
    The event topic this endpoint is subscribed to

  - `results.topic.name` (string)
    The event topic name
    Example: invoice.created

  - `results.topic.description` (string)
    Human-readable description of the event topic
    Example: Triggered when a new invoice record is created

  - `results.created_at` (string)
    When this webhook endpoint subscription was created
    Example: 2021-05-20T09:23:53+00:00

  - `results.updated_at` (string)
    When this webhook endpoint subscription was last updated
    Example: 2021-05-20T09:23:53+00:00

## Response 400:

  - `400` (unknown)
    Bad request error

## Response 400 fields (application/json):

  - `error` (object)

  - `error.message` (string)
    A short string, describing error details
    Example: Validation error

  - `error.type` (string)
    A short string, describing error type
    Enum: "validation_error"

  - `error.details` (array)

  - `error.details.path` (string)
    Path to the field failed validation
    Example: path.to.field

  - `error.details.message` (string)
    Detailed description of the error
    Example: `[field]` is required

## Response 401:

  - `401` (unknown)
    Unauthorized error

## Response 401 fields (application/json):

  - `error` (object)

  - `error.message` (string)
    A short string, describing error details
    Example: Invalid merchant credentials

  - `error.type` (string)
    A short string, describing error type
    Enum: "authentication_error"

## Response 429:

  - `429` (unknown)
    Rate limit error

## Response 429 fields (application/json):

  - `error` (object)

  - `error.message` (string)
    A short string, describing error details
    Example: Too many requests

  - `error.type` (string)
    A short string, describing error type
    Enum: "rate_limit_error"

## Response 200 examples:

  - `Response with multiple webhook endpoint subscriptions` (unknown)

  - `Response with no webhook endpoints configured` (unknown)