# List webhook subscriptions

**Documentation:** /reference/api-reference/webhooks/getWebhookSubscriptions

Lists all webhook subscriptions for the authenticated project with pagination. Currently limited to one subscription per project.

---

## GET `/api/v3/webhook_subscriptions`

**Endpoint:** `https://backend.composio.dev/api/v3/webhook_subscriptions`

**Summary:** List webhook subscriptions

Lists all webhook subscriptions for the authenticated project with pagination. Currently limited to one subscription per project.

### Authentication

**ApiKeyAuth** - API Key in `header` header `x-api-key` OR **UserApiKeyAuth** - API Key in `header` header `x-user-api-key`

### Query Parameters

- `limit` (number,null): Number of items per page, max allowed is 1000
- `cursor` (string): Cursor for pagination. The cursor is a base64 encoded string of the page and limit. The page is the page number and the limit is the number of items per page. The cursor is used to paginate through the items. The cursor is not required for the first page.

### Responses

#### 200 - Webhook subscriptions retrieved

**Response Schema:**

- `items` (array<object>) *(required)*
  - Array items:
    - `id` (string (webhookSubscriptionId)) *(required)*: Unique subscription ID
    - `webhook_url` (string) *(required)*: Webhook destination URL
    - `version` (enum: "V1" | "V2" | "V3") *(required)*: Webhook payload version
    - `enabled_events` (array<string>) *(required)*: Subscribed event types
    - `secret` (string) *(required)*: Masked signing secret (full secret only on create/rotate)
    - `created_at` (string) *(required)*: ISO 8601 timestamp
    - `updated_at` (string) *(required)*: ISO 8601 timestamp
- `next_cursor` (string,null)
- `total_pages` (number) *(required)*
- `current_page` (number) *(required)*
- `total_items` (number) *(required)*

**Example Response:**

```json
{
  "items": [
    {
      "id": "string",
      "webhook_url": "string",
      "version": "V1",
      "enabled_events": [
        "..."
      ],
      "secret": "string",
      "created_at": "string",
      "updated_at": "string"
    }
  ],
  "next_cursor": null,
  "total_pages": 1,
  "current_page": 1,
  "total_items": 1
}
```

#### 400 - Invalid pagination

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

#### 401 - Unauthorized

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

#### 500 - Internal server error

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

### Example cURL Request

```bash
curl -X GET "https://backend.composio.dev/api/v3/webhook_subscriptions" \
  -H "x-api-key: YOUR_API_KEY"
```