> ## Documentation Index > Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt > Use this file to discover all available pages before exploring further. # List Stream Monitors > List all stream monitors for the authenticated API key. Supports pagination and optional filtering by status. ## OpenAPI ````yaml get /v1/twitter/stream/monitors openapi: 3.1.0 info: title: ScrapeBadger Twitter API description: >- The ScrapeBadger Twitter API provides programmatic access to Twitter/X data through a simple REST interface. Retrieve tweets, user profiles, followers, lists, communities, trends, and geographic data — all with a single API key. All endpoints require authentication via the `x-api-key` header. Each request consumes credits from your account balance. Paginated endpoints return a `next_cursor` field that you can pass to subsequent requests to retrieve additional pages of results. **Base URL:** `https://scrapebadger.com/v1/twitter` **Rate Limits:** Requests are rate-limited per API key. If you exceed your limit, you will receive a `429` response. Implement exponential backoff and retry logic for production use. **Credits:** Each successful API call deducts credits from your balance. If your balance reaches zero, subsequent requests will return `402 Payment Required`. version: 1.0.0 contact: name: ScrapeBadger Support url: https://scrapebadger.com email: support@scrapebadger.com servers: - url: https://scrapebadger.com description: Production security: - apiKey: [] tags: - name: Tweets description: >- Retrieve tweets, search tweets, and access tweet metadata including replies, quotes, retweeters, favoriters, edit history, and community notes. - name: Users description: >- Retrieve user profiles, followers, following lists, mentions, subscriptions, and search for users. - name: Lists description: Access Twitter list details, list tweets, and search within lists. - name: Communities description: Retrieve community details, community tweets, and search for communities. - name: Trends description: Get trending topics globally or by location. - name: Geo description: Search for geographic places and retrieve place details. - name: Spaces description: Access Twitter Spaces and live broadcast details. - name: Stream Monitors description: >- Create and manage real-time stream monitors that track Twitter accounts and deliver new tweets via WebSocket or webhook. - name: Stream Webhooks description: >- Manage webhook endpoints for stream monitor delivery. Webhooks receive HMAC-SHA256 signed payloads when new tweets are detected. - name: Stream Logs description: >- Access delivery logs and billing logs for stream monitors. Track tweet detection latency, webhook delivery status, and credit consumption. - name: Filter Rules description: >- Create and manage filter rules that monitor Twitter using Advanced Search queries at configurable intervals. Delivered via WebSocket or webhook. paths: /v1/twitter/stream/monitors: get: tags: - Stream Monitors summary: List stream monitors description: >- List all stream monitors for the authenticated API key. Supports pagination and optional filtering by status. operationId: listStreamMonitors parameters: - name: page in: query required: false description: Page number for pagination. schema: type: integer default: 1 minimum: 1 - name: page_size in: query required: false description: Number of monitors per page. schema: type: integer minimum: 1 maximum: 100 default: 20 - name: status in: query required: false description: Filter monitors by status. schema: type: string enum: - active - paused responses: '200': description: Successfully retrieved stream monitors. content: application/json: schema: type: object properties: monitors: type: array items: $ref: '#/components/schemas/StreamMonitorResponse' total: type: integer description: Total number of monitors. page: type: integer description: Current page number. page_size: type: integer description: Number of items per page. '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/PaymentRequired' '429': $ref: '#/components/responses/RateLimitExceeded' components: schemas: StreamMonitorResponse: type: object description: Stream monitor configuration and status. required: - id - name - usernames - status - created_at - updated_at properties: id: type: string description: Unique stream monitor identifier. name: type: string description: Human-readable name of the monitor. example: Tech Leaders Monitor usernames: type: array items: type: string description: List of monitored Twitter usernames. example: - elonmusk - sama status: type: string enum: - active - paused - suspended description: >- Current status of the monitor. Suspended indicates the monitor was auto-paused due to insufficient credits. status_reason: type: - string - 'null' description: >- Reason for the current status, if applicable (e.g., "insufficient_credits"). webhook_url: type: - string - 'null' description: HTTPS URL receiving webhook deliveries. webhook_secret_set: type: boolean description: >- Whether a webhook secret is configured. The actual secret is never returned. filter_types: type: - array - 'null' items: type: string enum: - original - reply - retweet - quote description: Tweet types being delivered. Null means all types. credits_per_account_per_day: type: number description: Credit cost per monitored account per day. estimated_credits_per_day: type: number description: Estimated total credit cost per day based on current account count. pricing_tier: type: string description: Current pricing tier label. example: Standard created_at: type: string format: date-time description: Timestamp when the monitor was created. updated_at: type: string format: date-time description: Timestamp when the monitor was last updated. ErrorResponse: type: object description: Error response returned for failed requests. required: - error properties: error: type: string description: Human-readable error message describing what went wrong. responses: Unauthorized: description: Authentication failed. The API key is missing, invalid, or expired. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Invalid or missing API key PaymentRequired: description: >- Insufficient credits. Your account balance has been exhausted. Purchase more credits at https://scrapebadger.com/dashboard/billing. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Insufficient credits RateLimitExceeded: description: >- Rate limit exceeded. Too many requests in a given time period. Implement exponential backoff and retry. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: Rate limit exceeded. Please retry after a short delay. securitySchemes: apiKey: type: apiKey name: x-api-key in: header description: >- Your ScrapeBadger API key. You can find this in your dashboard at https://scrapebadger.com/dashboard/api-keys. ````