---
title: "list webhook subscriptions"
method: GET
path: "/instances/{id}/webhooks"
tags: ["webhooks"]
---

# list webhook subscriptions

`GET /instances/{id}/webhooks`

## Request

- Base URL: `https://waapi.app/api/v1`
- URL: `https://waapi.app/api/v1/instances/{id}/webhooks`
- Auth: HTTP bearer

Retrieve the webhook subscriptions registered on an instance.

## Path parameters

- `id` integer, required

## Response `200`

A JSON array of webhook subscriptions

- object
  - `data` WebhookSubscription[]
    - `id` integer
    - `url` string
    - `events` EventType[]
    - `source` 'zapier' | 'make' | 'n8n' | 'api'
    - `isActive` boolean
    - `createdAt` string, date-time

## Other responses

- `401`: Unauthorized — invalid or missing bearer token
- `403`: Forbidden — insufficient permissions or account blocked
- `404`: Not found — instance does not exist or does not belong to you
- `409`: Conflict — instance is not ready
- `422`: Validation error — invalid or missing request parameters
- `429`: Too many requests — rate limit exceeded

---

[API](https://skmtc.dev/waapi/apis/waapi-api-2.md) · [All operations](https://skmtc.dev/waapi/apis/waapi-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/waapi/apis/waapi-api-2/revisions/490302f75576?raw)