---
title: "Get the last 24h of application metrics"
method: GET
path: "/v2/apps/{appId}/metrics"
tags: ["Lifecycle"]
---

# Get the last 24h of application metrics

`GET /v2/apps/{appId}/metrics`

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

Available only for applications with at least 512 MB of RAM. Rate limited to 10 requests per 5s per user, with a 60s block on the cap.

## Path parameters

- `appId` string, required

## Response `200`

Array of metric points. Empty array when the application 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

- `400` — The application has less than 512 MB of RAM and cannot collect metrics.
- `401` — The Authorization header is missing, malformed, or the credentials are not valid.
- `404` — The target application could not be found, or the caller is not a member of the workspace.
- `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)
