> ## Documentation Index
> Fetch the complete documentation index at: https://upstash.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Metrics

> Returns usage metrics for a database created with start-redis.

This endpoint does not require authentication. It returns usage metrics for
a free database created with
[`POST /start-redis`](/docs/devops/developer-api/start-redis/create), so an agent
can check how the database is being used without a console login.

## Request

<ParamField path="id" type="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.
</ParamField>

<ParamField header="User-Agent" type="string">
  The name of the agent making the request, for example `claude-code`.
</ParamField>

## Response

<ResponseField name="uptime_seconds" type="number">
  Seconds since the database was created.
</ResponseField>

<ResponseField name="expires_at" type="string">
  When the database will be deleted unless claimed, as an ISO 8601 timestamp.
</ResponseField>

<ResponseField name="console_url" type="string">
  The console page where a user can view usage and claim the database.
</ResponseField>

<ResponseField name="commands_total" type="number">
  Total number of commands executed.
</ResponseField>

<ResponseField name="commands_per_sec_1m" type="number">
  Command throughput over the last minute.
</ResponseField>

<ResponseField name="keys" type="number">
  Number of keys in the database.
</ResponseField>

<ResponseField name="memory_bytes" type="number">
  Memory used by the data, in bytes.
</ResponseField>

<ResponseField name="bytes_in" type="number">
  Total bytes received by the database.
</ResponseField>

<ResponseField name="bytes_out" type="number">
  Total bytes sent by the database.
</ResponseField>

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

<RequestExample>
  ```sh curl theme={"system"}
  curl https://upstash.com/start-redis/metrics/<database-id> \
    -H "User-Agent: <your-agent-name>"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"system"}
  {
    "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
  }
  ```

  ```json 404 Not Found theme={"system"}
  "not found"
  ```
</ResponseExample>


## Related topics

- [Create a Free Database](/docs/devops/developer-api/start-redis/create.md)
- [Metrics and Charts](/docs/redis/howto/metrics-and-charts.md)
- [Get Index Stats](/docs/api-reference/vector/get-index-stats.md)
- [Get QStash Stats](/docs/api-reference/qstash/get-qstash-stats.md)