---
title: "List delivery logs"
method: GET
path: "/v1/twitter/stream/logs"
tags: ["Stream Logs"]
---

# List delivery logs

`GET /v1/twitter/stream/logs`

List tweet delivery logs for stream monitors. Shows each detected tweet with detection latency, delivery status, and webhook response details. Useful for monitoring stream health and debugging delivery issues.

## Query parameters

- `monitor_id` string
- `page` integer
- `page_size` integer

## Response `200`

Successfully retrieved delivery logs.

- object
  - `logs` TweetDeliveryLogResponse[]
    - `id` string, required — Unique log entry identifier.
    - `monitor_id` string, required — ID of the stream monitor that detected the tweet.
    - `monitor_name` string — Name of the stream monitor.
    - `tweet_id` string, required — ID of the detected tweet.
    - `author_username` string — Username of the tweet author.
    - `tweet_text_preview` string, nullable — Truncated preview of the tweet text.
    - `tweet_url` string — Full URL to the tweet on Twitter/X.
    - `tweet_published_at` string, date-time — Timestamp when the tweet was originally published.
    - `detected_at` string, date-time — Timestamp when the tweet was detected by the monitor.
    - `latency_ms` integer — Detection latency in milliseconds (time between tweet publication and detection).
    - `latency_badge` string — Human-readable latency badge (e.g., "fast", "normal", "slow").
    - `delivery_status` string, required — Overall delivery status (e.g., "delivered", "failed", "pending").
    - `webhook_status_code` integer, nullable — HTTP status code returned by the webhook endpoint, if applicable.
    - `webhook_attempts` integer — Number of webhook delivery attempts.
  - `total` integer — Total number of delivery logs.
  - `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)