qstash

Get QStash Stats

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

get/qstash/stats/{id}

Request

Path parameters

idstring required

QStash user ID

Query parameters

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

Time period for statistics aggregation. Each period returns 60 datapoints with intervals adjusted to the period length.

Exceptionally for 30 days, it returns 240 datapoints with 3-hour intervals for increased granularity.

Response

Successful response with usage statistics

daysstring[]

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.

dlq_message_countinteger

Current number of messages in the dead letter queue

total_monthly_billingnumber float

Total billing amount for the current month

Example response

{
  "days": [
    "Wednesday",
    "Thursday",
    "Friday",
    "Saturday",
    "Sunday",
    "Monday",
    "Tuesday"
  ],
  "daily_requests": [
    {
      "x": "2025-10-01 11:33:05.585757103 +0000 UTC",
      "y": 0,
      "workflow_message": 0,
      "workflow_run": 0
    }
  ],
  "daily_billings": [
    {
      "x": "2025-10-01 11:33:05.585757103 +0000 UTC",
      "y": 0
    }
  ],
  "daily_bandwidths": [
    {
      "x": "2025-10-01 11:33:05.585757103 +0000 UTC",
      "y": 0
    }
  ],
  "daily_used": [
    {
      "x": "2025-10-01 11:33:05.585757103 +0000 UTC",
      "y": 0
    }
  ],
  "daily_used_workflow": [
    {
      "x": "2025-10-01 11:33:05.585757103 +0000 UTC",
      "y": 0
    }
  ],
  "daily_qstash_messages": [
    {
      "id": "delivered",
      "data_points": [
        {
          "x": "2023-05-22 10:59:23.426 +0000 UTC",
          "y": 320
        },
        {
          "x": "2023-05-22 11:00:23.426 +0000 UTC",
          "y": 450
        }
      ]
    }
  ],
  "daily_workflow_messages": [
    {
      "id": "canceled",
      "data_points": [
        {
          "x": "2023-05-22 10:59:23.426 +0000 UTC",
          "y": 320
        },
        {
          "x": "2023-05-22 11:00:23.426 +0000 UTC",
          "y": 450
        }
      ]
    }
  ],
  "daily_bandwidth_used": [
    {
      "x": "2025-10-01 11:33:05.585757103 +0000 UTC",
      "y": 0
    }
  ],
  "total_monthly_billing": 5.806
}

Changes

No recorded changes to this operation across all 3 revisions of this API.