---
title: "List webhooks"
method: GET
path: "/v1/twitter/stream/webhooks"
tags: ["Stream Webhooks"]
---

# List webhooks

`GET /v1/twitter/stream/webhooks`

List all webhooks for the authenticated API key. Optionally filter by monitor ID.

## Query parameters

- `monitor_id` string

## Response `200`

Successfully retrieved webhooks.

- object
  - `webhooks` WebhookListItem[]
    - `id` string, required — Unique webhook identifier.
    - `monitor_id` string, required — ID of the associated stream monitor.
    - `monitor_name` string — Name of the associated stream monitor.
    - `url` string, required — HTTPS URL of the webhook endpoint.
    - `secret_set` boolean, required — Whether a secret is configured for this webhook.
    - `created_at` string, date-time, required — Timestamp when the webhook was created.
  - `total` integer — Total number of webhooks.

## Other responses

- `401` — Authentication failed. The API key is missing, invalid, or expired.
- `402` — Insufficient credits. Your account balance has been exhausted. Purchase more credits at https://scrapebadger.com/dashboard/billing.
- `429` — Rate limit exceeded. Too many requests in a given time period. Implement exponential backoff and retry.

---

[API](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api.md) · [All operations](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scrapebadger/scrapebadger-account-api/revisions/4a1ef8777baf/schema)