Skip to main content
GET
/
qstash
/
stats
Get QStash Stats
curl --request GET \
  --url https://api.upstash.com/v2/qstash/stats \
  --header 'Authorization: Basic <encoded-value>'
{
  "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
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Query Parameters

​
period
enum<string>
default:1h

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.

Available options:
1h,
3h,
12h,
1d,
3d,
7d,
30d

Response

200 - application/json

Successful response with usage statistics

​
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.

Example:
[
  "Wednesday",
  "Thursday",
  "Friday",
  "Saturday",
  "Sunday",
  "Monday",
  "Tuesday"
]
​
daily_requests
object[]

Daily request metrics including workflow breakdowns

Example:
[
  {
    "x": "2025-10-01 11:33:05.585757103 +0000 UTC",
    "y": 0,
    "workflow_message": 0,
    "workflow_run": 0
  }
]
​
daily_billings
object[]

Daily billing amounts over time

Example:
[
  {
    "x": "2025-10-01 11:33:05.585757103 +0000 UTC",
    "y": 0
  }
]
​
daily_bandwidths
object[]

Daily bandwidth usage over time

Example:
[
  {
    "x": "2025-10-01 11:33:05.585757103 +0000 UTC",
    "y": 0
  }
]
​
daily_used
object[]

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.

Example:
[
  {
    "x": "2025-10-01 11:33:05.585757103 +0000 UTC",
    "y": 0
  }
]
​
daily_used_workflow
object[]

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.

Example:
[
  {
    "x": "2025-10-01 11:33:05.585757103 +0000 UTC",
    "y": 0
  }
]
​
daily_qstash_messages
object[]

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.

Example:
[
  {
    "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
object[]

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.

Example:
[
  {
    "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
integer

Current number of messages in the dead letter queue

Example:

0

​
daily_bandwidth_used
object[]

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.

Example:
[
  {
    "x": "2025-10-01 11:33:05.585757103 +0000 UTC",
    "y": 0
  }
]
​
total_monthly_billing
number

Total billing amount for the current month

Example:

5.806