---
title: "Get QStash Stats"
method: GET
path: "/qstash/stats/{id}"
tags: ["qstash"]
---

# Get QStash Stats

`GET /qstash/stats/{id}`

## Request

- Base URL: `https://api.upstash.com/v2`
- URL: `https://api.upstash.com/v2/qstash/stats/{id}`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/upstash/apis/developer-api-upstash/docs/qstash/stats/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves detailed usage statistics for the QStash account including
daily requests, billing, bandwidth, and workflow metrics over time.

## Path parameters

- `id` string, required

## Query parameters

- `period` '1h' | '3h' | '12h' | '1d' | '3d' | '7d' | '30d'

## Response `200`

Successful response with usage statistics

- QStashStats
  - `days` string[]: Array of day names for the measurement period, typically representing all days in the current month. This includes both past and future dates within the current month, so the array covers the entire month regardless of the current day. Future days are included to align with other daily metrics arrays, allowing for consistent indexing.
  - `daily_requests` object[]: Daily request metrics including workflow breakdowns
    - `x` string: Timestamp in UTC format
    - `y` number: Total request count for this day
    - `workflow_message` integer: Number of workflow messages for this day
    - `workflow_run` integer: Number of workflow runs for this day
  - `daily_billings` TimeSeriesData[]: Daily billing amounts over time
    - `x` string, required: Timestamp when measurement was taken
    - `y` number, required: The measured value
  - `daily_bandwidths` TimeSeriesData[]: Daily bandwidth usage over time
    - `x` string, required: Timestamp when measurement was taken
    - `y` number, required: The measured value
  - `daily_used` TimeSeriesData[]: Request counts for the requested time period If 1h is specified, it shows 60 data points for every 1 minute within the last 1 hour.
    - `x` string, required: Timestamp when measurement was taken
    - `y` number, required: The measured value
  - `daily_used_workflow` TimeSeriesData[]: Workflow usage metrics for the requested time period If 1h is specified, it shows 60 data points for every 1 minute within the last 1 hour.
    - `x` string, required: Timestamp when measurement was taken
    - `y` number, required: The measured value
  - `daily_qstash_messages` TimeSeriesWithId[]: QStash message counts broken down by metric identifier for the requested time period. If 1h is specified, it shows 60 data points for every 1 minute within the last 1 hour.
    - `id` string: Identifier for the time series data
    - `data_points` TimeSeriesData[]: Data points for the time series
      - `x` string, required: Timestamp when measurement was taken
      - `y` number, required: The measured value
  - `daily_workflow_messages` TimeSeriesWithId[]: Workflow metrics broken down by metric identifier for the requested time period. If 1h is specified, it shows 60 data points for every 1 minute within the last 1 hour.
    - `id` string: Identifier for the time series data
    - `data_points` TimeSeriesData[]: Data points for the time series
      - `x` string, required: Timestamp when measurement was taken
      - `y` number, required: The measured value
  - `dlq_message_count` integer: Current number of messages in the dead letter queue
  - `daily_bandwidth_used` TimeSeriesData[]: Bandwidth usage for the requested time period If 1h is specified, it shows 60 data points for every 1 minute within the last 1 hour.
    - `x` string, required: Timestamp when measurement was taken
    - `y` number, required: The measured value
  - `total_monthly_billing` number, float: Total billing amount for the current month

---

[API](https://skmtc.dev/upstash/apis/developer-api-upstash.md) - [All operations](https://skmtc.dev/upstash/apis/developer-api-upstash/llms.txt) - [OpenAPI document](https://skmtc.dev/upstash/apis/developer-api-upstash/revisions/bddbdcab9052?raw)