# Get QStash Stats

> Retrieves detailed usage statistics for the QStash account including

## Endpoint

`GET https://api.upstash.com/v2/qstash/stats/{id}`

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


## Parameters

- `id` (path, string, required): QStash user ID
- `period` (query, enum<string>): 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.


## Responses

### 200 - 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.

- `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` (object[]): Daily billing amounts over time
  - `x` (string): Timestamp when measurement was taken
  - `y` (number): The measured value
- `daily_bandwidths` (object[]): Daily bandwidth usage over time
  - `x` (string): Timestamp when measurement was taken
  - `y` (number): The measured value
- `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.

  - `x` (string): Timestamp when measurement was taken
  - `y` (number): The measured value
- `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.

  - `x` (string): Timestamp when measurement was taken
  - `y` (number): The measured value
- `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.

  - `id` (string): Identifier for the time series data
  - `data_points` (object[]): Data points for the time series
    - `x` (string): Timestamp when measurement was taken
    - `y` (number): The measured value
- `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.

  - `id` (string): Identifier for the time series data
  - `data_points` (object[]): Data points for the time series
    - `x` (string): Timestamp when measurement was taken
    - `y` (number): The measured value
- `dlq_message_count` (integer): Current number of messages in the dead letter queue
- `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.

  - `x` (string): Timestamp when measurement was taken
  - `y` (number): The measured value
- `total_monthly_billing` (number): Total billing amount for the current month

## cURL

```bash
curl --request GET \
  --url https://api.upstash.com/v2/qstash/stats/{id} \
  --header 'Authorization: Bearer <token>'
```