---
title: "Get the last 24h of database metrics"
method: GET
path: "/v2/databases/{databaseId}/metrics"
tags: ["DB Lifecycle"]
---

# Get the last 24h of database metrics

`GET /v2/databases/{databaseId}/metrics`

Returns up to 288 points (24h sampled every 5 minutes) of CPU, RAM and network usage for the database. Cached for 2.5 minutes per (user, database).

Rate limited to 10 requests per 5s per user, with a 60s block on the cap.

## Path parameters

- `databaseId` string, required

## Response `200`

Array of metric points. Empty when the database has no recent data.

- object
  - `status` 'success', required
  - `response` object[], required
    - `date` string, date-time, required
    - `cpu` number, required
    - `ram` number, required
    - `net` integer[], required

## Other responses

- `401` — The Authorization header is missing, malformed, or the credentials are not valid.
- `404` — The database does not exist or is not owned by the caller.
- `429` — The endpoint enforces its own rate limit and the caller hit the cooldown.
- `500` — An unexpected error occurred while processing the request.

---

[API](https://skmtc.dev/squarecloud/apis/square-cloud-api.md) · [All operations](https://skmtc.dev/squarecloud/apis/square-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/squarecloud/square-cloud-api/revisions/54b7733a6b95/schema)
