# List webhook endpoints

This method retrieves a list of your previously created webhook endpoints.

Endpoint: GET /webhooks/endpoints
Version: 1.0.0
Security: MerchantID

## Header parameters:

  - `merchant` (string, required)
    Unique public key provided upon registration and must be shared for identification purposes.
    Example: "api_pk_7b197...ba108f842"

  - `signature` (string, required)
    Request signature that allows verification of merchant authenticity on the payment gateway server.
    Example: "M2E3OTkyNzcz...xMmExODI4"

## Query parameters:

  - `filter[id]` (string)
    Comma-separated webhook identifiers.
    Example: "ac43b415-5522-4373-b026-a365462f9657"

  - `pagination[limit]` (integer)
    Number of items to return.
    Example: 10

  - `pagination[offset]` (integer)
    Number of items to skip before collecting the result set.
    Example: 10

## Response 200 fields (application/json):

  - `body` (object) — one of:
    - Success:
      - `data` (array)
        Contains an array of webhook data, each representing a specific webhook configuration.
      - `data.id` (string)
        Webhook endpoint identifier.
      - `data.url` (string)
        URL for webhook event delivery.
      - `data.event_types` (array)
        List of event types the webhook endpoint is subscribed to.
      - `data.name` (string)
        Field for storing the webhook configuration name.
      - `data.status` (string)
        Webhook endpoint status.
        Enum: "active", "inactive"
      - `data.created_at` (string)
        Date when the webhook endpoint was created.
      - `data.updated_at` (string)
        Date when the webhook endpoint was last updated.
      - `pagination` (object)
        Contains information about the pagination of the results.
      - `pagination.offset` (integer, required)
        Starting index of the returned results.
        Example: 20
      - `pagination.limit` (integer, required)
        Maximum number of items to return.
        Example: 10
      - `pagination.total_count` (integer, required)
        Total count of the webhook endpoints available.
        Example: 150
    - Authentication failed:
      - `error` (object, required)
        Error object.
      - `error.code` (string, required)
        Unauthorized access due to invalid credentials.
        Example: "1.01"
      - `error.messages` (array, required)
        Array of error messages applied to the decline payment.
        Example: ["Authentication failed"]

## Response 400 fields (application/json):

  - `error` (object)
    Error object.

  - `error.code` (string, required)
    Error 2.01 code.
    Enum: "2.01"

  - `error.message` (string, required)
    Invalid request.


  Missing or incorrect parameters.

  - `error.constraints` (object)
    An object containing validation errors for specific fields. 
Keys are field names, and values are lists of violations with error codes and messages.