# List Webhook Subscriptions

Retrieve all webhook subscriptions for the current organization.

Endpoint: GET /v1/webhook-subscriptions
Security: OAuth2

## Query parameters:

  - `cursor` (string)
    Pagination cursor for fetching the next page of results.
Omit or pass an empty string to start from the beginning of the list.

  - `limit` (integer)
    Maximum number of items to return per page.

## Response 200 fields (application/json):

  - `next` (string)
    Cursor for the next page of results.
An empty string or absent value indicates the end of the list.

  - `items` (array)

  - `items.id` (string, required)
    The unique identifier of the subscription.

  - `items.url` (string, required)
    The URL to send webhook events to.

  - `items.event_types` (array, required)
    List of event types this subscription is subscribed to.

  - `items.state` (string, required)
    The state of the subscription.
    Enum: "ENABLED", "DISABLED"

  - `items.created_at` (string, required)
    Timestamp of when the subscription was created.

  - `items.updated_at` (string, required)
    Timestamp of when the subscription was last updated.

  - `items.description` (string)
    A description of the subscription.

  - `items.metadata` (object)
    Additional metadata for the subscription.

This property lets you add custom data to the subscription.
The key has a limit of 40 characters and the value has a limit of 500 characters.

## Response 400 fields (application/json):

  - `message` (string, required)

  - `code` (string, required)

## Response default fields (application/json):

  - `message` (string, required)

  - `code` (string, required)