Get Metrics - Upstash Documentation

curl https://upstash.com/start-redis/metrics/<database-id> \
  -H "User-Agent: <your-agent-name>"

{
  "uptime_seconds": 1,
  "expires_at": "2026-08-28T13:25:49Z",
  "console_url": "https://upstash.com/start-redis/console/3b1f7c2e-9d4a-4c8b-a1e5-6f2d8e9c0b47",
  "commands_total": 0,
  "commands_per_sec_1m": 0,
  "keys": 0,
  "memory_bytes": 0,
  "bytes_in": 0,
  "bytes_out": 0
}

"not found"

GET

start-redis

metrics

{id}

curl https://upstash.com/start-redis/metrics/<database-id> \
  -H "User-Agent: <your-agent-name>"

{
  "uptime_seconds": 1,
  "expires_at": "2026-08-28T13:25:49Z",
  "console_url": "https://upstash.com/start-redis/console/3b1f7c2e-9d4a-4c8b-a1e5-6f2d8e9c0b47",
  "commands_total": 0,
  "commands_per_sec_1m": 0,
  "keys": 0,
  "memory_bytes": 0,
  "bytes_in": 0,
  "bytes_out": 0
}

"not found"

This endpoint does not require authentication. It returns usage metrics for a free database created with POST /start-redis, so an agent can check how the database is being used without a console login.

Request

string

required

The database ID: the UUID you sent as Idempotency-Key when creating the database, or the ID returned in the response if you omitted it.

string

The name of the agent making the request, for example claude-code.

Response

number

Seconds since the database was created.

string

When the database will be deleted unless claimed, as an ISO 8601 timestamp.

string

The console page where a user can view usage and claim the database.

number

Total number of commands executed.

number

Command throughput over the last minute.

number

Number of keys in the database.

number

Memory used by the data, in bytes.

number

Total bytes received by the database.

number

Total bytes sent by the database.

Returns 404 Not Found if no database exists with that ID.

curl https://upstash.com/start-redis/metrics/<database-id> \
  -H "User-Agent: <your-agent-name>"

{
  "uptime_seconds": 1,
  "expires_at": "2026-08-28T13:25:49Z",
  "console_url": "https://upstash.com/start-redis/console/3b1f7c2e-9d4a-4c8b-a1e5-6f2d8e9c0b47",
  "commands_total": 0,
  "commands_per_sec_1m": 0,
  "keys": 0,
  "memory_bytes": 0,
  "bytes_in": 0,
  "bytes_out": 0
}

"not found"

​Request

​Response

Request

Response