Skip to main content
Upstash Documentation

Get Metrics

Returns usage metrics for a database created with start-redis.
1 min read
gethttps://upstash.com/start-redis/metrics/{id}
gethttps://upstash.com/start-redis/metrics/{id}

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#

idstringrequired#

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.

User-Agentstring#

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

Response#

uptime_secondsnumber#

Seconds since the database was created.

expires_atstring#

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

console_urlstring#

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

commands_totalnumber#

Total number of commands executed.

commands_per_sec_1mnumber#

Command throughput over the last minute.

keysnumber#

Number of keys in the database.

memory_bytesnumber#

Memory used by the data, in bytes.

bytes_innumber#

Total bytes received by the database.

bytes_outnumber#

Total bytes sent by the database.

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