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

**id** `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.

**User-Agent** `string`

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

## Response

**uptime\_seconds** `number`

Seconds since the database was created.

**expires\_at** `string`

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

**console\_url** `string`

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

**commands\_total** `number`

Total number of commands executed.

**commands\_per\_sec\_1m** `number`

Command throughput over the last minute.

**keys** `number`

Number of keys in the database.

**memory\_bytes** `number`

Memory used by the data, in bytes.

**bytes\_in** `number`

Total bytes received by the database.

**bytes\_out** `number`

Total bytes sent by the database.

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

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

```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"
```


## 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 Database Insights](/docs/devops/developer-api/redis/get_database_insights.md)
- [Get Index Stats](/docs/api-reference/vector/get-index-stats.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.