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

# List billing logs

`GET /v1/twitter/stream/billing-logs`

List billing logs for stream monitors. Shows credit deductions with billing cadence details, tier rates, and account counts. Useful for tracking streaming costs and verifying billing accuracy.

## Query parameters

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

## Response `200`

Successfully retrieved billing logs.

- object
  - `logs` BillingLogResponse[]
    - `id` string, required — Unique billing log identifier.
    - `monitor_id` string, required — ID of the stream monitor.
    - `monitor_name` string — Name of the stream monitor.
    - `billed_at` string, date-time, required — Timestamp of the billing event.
    - `num_accounts` integer — Number of monitored accounts at the time of billing.
    - `credits_deducted` number, required — Total credits deducted in this billing cycle.
    - `tier_label` string — Pricing tier label applied.
    - `rate_applied` number — Credit rate per account per day that was applied.
  - `total` integer — Total number of billing 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)