Get QStash Stats
Retrieves detailed usage statistics for the QStash account including
curl --request GET \
--url https://api.upstash.com/v2/qstash/stats/{id} \
--header 'Authorization: Bearer <token>'{
"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
}
]
}
],
"dlq_message_count": 0,
"daily_bandwidth_used": [
{
"x": "2025-10-01 11:33:05.585757103 +0000 UTC",
"y": 0
}
],
"total_monthly_billing": 5.806
}Authorization
Bearer authentication header of the form Bearer <token>.
Path parameters
QStash user ID
Query parameters
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
200 — Successful response with usage statistics
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 request metrics including workflow breakdowns
Daily billing amounts over time
Daily bandwidth usage over time
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.
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.
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.
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.
Current number of messages in the dead letter queue
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.
Total billing amount for the current month