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

# List stream monitors

`GET /v1/twitter/stream/monitors`

List all stream monitors for the authenticated API key. Supports pagination and optional filtering by status.

## Query parameters

- `page` integer
- `page_size` integer
- `status` 'active' | 'paused'

## Response `200`

Successfully retrieved stream monitors.

- object
  - `monitors` StreamMonitorResponse[]
    - `id` string, required — Unique stream monitor identifier.
    - `name` string, required — Human-readable name of the monitor.
    - `usernames` string[], required — List of monitored Twitter usernames.
    - `status` 'active' | 'paused' | 'suspended', required — Current status of the monitor. Suspended indicates the monitor was auto-paused due to insufficient credits.
    - `status_reason` string, nullable — Reason for the current status, if applicable (e.g., "insufficient_credits").
    - `webhook_url` string, nullable — HTTPS URL receiving webhook deliveries.
    - `webhook_secret_set` boolean — Whether a webhook secret is configured. The actual secret is never returned.
    - `filter_types` string[], nullable — Tweet types being delivered. Null means all types.
    - `credits_per_account_per_day` number — Credit cost per monitored account per day.
    - `estimated_credits_per_day` number — Estimated total credit cost per day based on current account count.
    - `pricing_tier` string — Current pricing tier label.
    - `created_at` string, date-time, required — Timestamp when the monitor was created.
    - `updated_at` string, date-time, required — Timestamp when the monitor was last updated.
  - `total` integer — Total number of monitors.
  - `page` integer — Current page number.
  - `page_size` integer — Number of items per page.

## 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)