Get QStash
Retrieves detailed information about the specified QStash user, including plan details, limits, and configuration
curl --request GET \
--url https://api.upstash.com/v2/qstash/user/{id} \
--header 'Authorization: Bearer <token>'{
"customer_id": "example@upstash.com",
"id": "99a4c327-31f0-490f-a594-043ade84085a",
"token": "ZXhhbXBsZUB1cHN0YXNoLmNvbTpuYWJlcg==",
"read_only_token": "ZXhhbXBsZUB1cHN0YXNoLmNvbTpuYWJlcg==",
"active": true,
"state": "active",
"modifying_state": "suspended",
"last_plan_upgrade_time": 0,
"max_message_size": 1048576,
"max_requests_per_day": 1000,
"max_requests_per_day_hard": 1000,
"max_endpoints_per_topic": 100,
"max_requests_per_second": 100,
"max_dlq_size": 1000000,
"max_retries": 999,
"max_topics": 1,
"max_schedules": 10,
"max_events_size": 10000,
"max_dlq_retention_time_milis": 259200000,
"max_delay": 604800,
"max_parallelism": 2,
"max_global_parallelism": 10,
"max_queues": 10,
"max_bandwidth_per_second": 1048576,
"prod_pack_enabled": false,
"prometheus_enabled": "false",
"timeout": 900,
"type": "free",
"region": "eu-central-1",
"reserved_type": "",
"reserved_price": 0,
"created_by": "cahidarda@upstash.com",
"creation_time": 1781871358,
"deletion_time": 0,
"budget": 0,
"enterprise": {
"enabled": true
}
}Authorization
Bearer authentication header of the form Bearer <token>.
Path parameters
QStash user ID
Response
200 — Successful response
Customer identifier (email or team ID)
Unique identifier for the QStash user account
Authentication token for QStash operations
Read-only authentication token for QStash operations
Whether the QStash account is active
Current state of the QStash account (e.g. active, passive; other values may be returned)
Transitional state while the console applies an async change (e.g. suspended during suspension). Omitted when no change is in progress.
Unix timestamp of the last plan upgrade
Maximum message size in bytes
Soft limit for maximum requests per day
Hard limit for maximum requests per day
Maximum number of endpoints allowed per topic
Maximum requests per second (rate limit)
Maximum dead letter queue size
Maximum number of retry attempts for failed messages
Maximum number of topics allowed
Maximum number of schedules allowed
Maximum size for events
Maximum retention time for dead letter queue in milliseconds
Maximum delay for scheduled messages in seconds
Maximum parallel processing per endpoint
Maximum global parallel processing across all endpoints
Maximum number of queues allowed
Maximum bandwidth per second in bytes
Whether production pack features are enabled
Whether Prometheus metrics export is enabled ("true" / "false" string as returned by the API)
Request timeout in seconds
Account billing plan category
Region where the QStash instance is deployed
Fixed-tier or enterprise label when applicable. May be empty/absent for non-fixed plans.
Known values include qstash_fixed_1m, qstash_fixed_10m, qstash_fixed_100m, qstash_fixed.
Enterprise accounts may use the prefix enterprise: followed by an identifier (e.g. enterprise:acme).
Reserved plan price (may be 0)
Email of the user who created this account
Unix timestamp of account creation
Unix timestamp of account deletion (0 if not deleted)
Monthly spending budget limit in dollars. 0 means no limit.
Present for enterprise accounts