---
title: "Get runtime stats for a database"
method: GET
path: "/v2/databases/{databaseId}/status"
tags: ["DB Lifecycle"]
---

# Get runtime stats for a database

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

Returns live runtime stats (CPU, RAM, network, uptime) for a single database. Append `?rawData=true` to skip post-processing.

## Path parameters

- `databaseId` string, required

## Query parameters

- `rawData` 'true' | 'false'

## Response `200`

Runtime stats for the database.

- object
  - `status` 'success', required
  - `response` RuntimeStats, required
    - `cpu` union, required — CPU usage. Formatted (`"0.50%"`) by default, or raw with `?rawData=true`.
      - string
      - number
    - `ram` union, required — RAM usage. Formatted (`"120/512MB"`) by default, or raw with `?rawData=true`.
      - string
      - number
    - `status` string, required — Resource lifecycle state (e.g. `running`, `exited`).
    - `running` boolean, required — Convenience flag equivalent to `status === "running"`.
    - `storage` union, required — Storage usage. Formatted by default, or raw bytes with `?rawData=true`.
      - string
      - integer
    - `network` object, required — Network counters. Strings by default (`"<incoming> ↑ <outgoing> ↓"`); two-element `[in, out]` integer arrays with `?rawData=true`.
      - `total` union, required
        - string
        - integer[]
      - `now` union, required
        - string
        - integer[]
    - `uptime` integer, nullable, required — Unix timestamp (ms) at which the resource last started. `null` when not running.

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