---
title: List webhooks
url: https://anyrow.ai/docs/api/webhooks/list
canonical_url: https://anyrow.ai/docs/api/webhooks/list
---

# List webhooks

`GET /v1/organizations/{organization_id}/webhooks`

Authentication: `Authorization: ApiKey {your_api_key}`.

## Path parameters

- `organization_id` (string, required)

## Query parameters

- `cursor` (string, optional): Opaque cursor for forward pagination. Pass the nextCursor from the previous response with the same order. Takes precedence over page when both are sent.
- `page` (integer, optional): 1-based page number for offset pagination. Ignored when cursor is present. At least 1.
- `order` (string, optional): Sort keys, comma-separated, each `field[.asc|.desc][.nullsfirst|.nullslast]`; at most 3. Sortable: created_at, active. Default: created_at.desc. Nulls sort last ascending and first descending unless stated. Matches `^(?:created_at|active)(?:\.(?:asc|desc))?(?:\.(?:nullsfirst|nullslast))?(?:,(?:created_at|active)(?:\.(?:asc|desc))?(?:\.(?:nullsfirst|nullslast))?){0,2}$`.
- `filter` (string, optional): Filter expression `field.op.value`; `,` joins conditions with AND; group with `or(...)` and `and(...)`. Fields: active (boolean: eq, ne, neq, is); created_at (number: eq, ne, neq, gt, gte, lt, lte, in, nin, is); id (string: eq, ne, neq, like, ilike, in, nin, is); name (string: eq, ne, neq, like, ilike, in, nin, is). `like` is case-sensitive and `ilike` ignores ASCII case; `*` is the wildcard. `in`/`nin` take `(a,b)`; `is` takes `null` or `notnull`. At most 20 conditions, 3 nested groups, 100 in/nin values.
- `q` (string, optional): Free-text search over: name, url. Whitespace-separated terms must all match. Up to 200 characters.
- `limit` (integer, optional): Maximum number of items per page. Defaults to 20, capped by the endpoint's maxLimit. Defaults to `20`. Between 1 and 100.

## Returns

200 `application/json`.

- `count` (integer, required): At least 0.
- `hasMore` (boolean, required)
- `limit` (integer, required): At least 1.
- `nextCursor` (string, required, nullable)
- `page` (integer, required, nullable): At least 1.
- `webhooks` (array of objects, required)
  - `created_at` (integer, required): At least 0.
  - `updated_at` (integer, required): At least 0.
  - `id` (string, required): 1 to 48 characters.
  - `name` (string, required, nullable): Up to 64 characters.
  - `organization_id` (string, required): 1 to 48 characters.
  - `url` (string, required): Up to 2048 characters.
  - `secret_rotated_at` (integer, required, nullable): At least 0.
  - `active` (boolean, required)
  - `failure_count` (integer, required): At least 0.
  - `last_triggered_at` (integer, required, nullable): At least 0.
  - `events` (array of strings, required): At least 1 items.

## Errors

- 404: `not_found`

Errors every endpoint can return: [Errors](https://anyrow.ai/docs/api/errors.md).

## Request

```ts title="Node.js"
import { AnyrowSDK } from "@anyrow/sdk"

const anyrow = new AnyrowSDK({
  baseURL: "https://api.anyrow.ai",
  headers: { Authorization: `ApiKey ${process.env.ANYROW_API_KEY}` },
})

const { data, error } = await anyrow.webhook.list({
  params: {
    organization_id: "{organization_id}"
  },
})
```

```bash title="cURL"
curl 'https://api.anyrow.ai/v1/organizations/{organization_id}/webhooks' \
  -H 'Authorization: ApiKey {your_api_key}'
```

```js title="JavaScript"
const response = await fetch("https://api.anyrow.ai/v1/organizations/{organization_id}/webhooks", {
  headers: {
    Authorization: "ApiKey {your_api_key}",
  },
})
const data = await response.json()
```

```python title="Python"
import requests

response = requests.get(
    "https://api.anyrow.ai/v1/organizations/{organization_id}/webhooks",
    headers={
        "Authorization": "ApiKey {your_api_key}",
    },
)
print(response.json())
```

## Response

```json title="200"
{
  "count": 0,
  "hasMore": true,
  "limit": 1,
  "nextCursor": "string",
  "page": 1,
  "webhooks": [
    {
      "created_at": 1711468800000,
      "updated_at": 1711468800000,
      "id": "whook_01h5a3g8k9m2n4p6q8r0t2v4x6",
      "name": "string",
      "organization_id": "string",
      "url": "https://example.com",
      "secret_rotated_at": 1711468800000,
      "active": true,
      "failure_count": 42,
      "last_triggered_at": 1711468800000,
      "events": [
        "batch.complete"
      ]
    }
  ]
}
```