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

# Get application status

> Get an application's live CPU, RAM, storage, network and uptime with GET /v2/apps/{app_id}/status. Pass rawData=true for numbers instead of strings.

<ParamField header="Authorization" type="string" placeholder="API Key" required>
  The API key for your account. You can find this in your [account settings](https://squarecloud.app/en/account/security).
</ParamField>

Requires an API key with the `apps:read` [scope](/en/api-reference/authentication#scopes).

Returns the application's current CPU, RAM, storage, network, and uptime figures, formatted as human-readable strings by default (e.g. `"120.4MB"`, `"602 KB ↑ 134 KB ↓"`). Pass `rawData=true` to get the same fields as raw numbers instead, which is easier to work with if you are charting the values yourself.

If you also have a [Real-time Logs](/en/api-reference/endpoint/apps/realtime) connection open for the same application, prefer the `status` events on that stream: while a realtime connection is active, this endpoint's numbers can lag behind by up to about a minute. To check every application at once instead of one at a time, see [All Applications Status](/en/api-reference/endpoint/apps/status-all).

## Parameters

<ParamField path="app_id" type="string" placeholder="Application ID" required>
  The ID of the application. You can find this in the URL of your application's dashboard.
</ParamField>

<ParamField query="rawData" type="boolean" placeholder="true or false">
  When `true`, `cpu`, `ram` and the other figures come as numbers instead of formatted strings.
</ParamField>

## Response

<ResponseField name="status" type="string">
  Indicates whether the call was successful: `success` if it was, `error` if not.
</ResponseField>

<ResponseField name="response" type="object">
  The contents of the response.

  <Expandable title="Toggle object">
    <ResponseField name="cpu" type="string">
      The CPU usage of the application.
    </ResponseField>

    <ResponseField name="ram" type="string">
      The RAM in use, for example `"120.4MB"`. It does not include the allocated limit.
    </ResponseField>

    <ResponseField name="status" type="string">
      The status of the application.
    </ResponseField>

    <ResponseField name="running" type="boolean">
      Indicates whether the application is currently running.
    </ResponseField>

    <ResponseField name="storage" type="string">
      The storage used by the application.
    </ResponseField>

    <ResponseField name="network" type="object">
      <Expandable title="Toggle object">
        <ResponseField name="total" type="string">
          The total network usage of the application.
        </ResponseField>

        <ResponseField name="now" type="string">
          The current network usage of the application.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="uptime" type="number">
      The uptime of the application in milliseconds.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={"system"}
  {
      "status": "success",
      "response": {
          "cpu": "0.01%",
          "ram": "120.4MB",
          "status": "running",
          "running": true,
          "storage": "2.72MB",
          "network": {
              "total": "602 KB ↑ 134 KB ↓",
              "now": "14 KB ↑ 3.3 KB ↓"
          },
          "uptime": 1662927833666
      }
  }
  ```
</ResponseExample>

## Common errors

| Code | HTTP | Meaning |
| - | - | - |
| `APP_NOT_FOUND` | 404 | The application does not exist or does not belong to the caller. |

## Related

* CLI: [`squarecloud app status`](/en/cli-reference/status-and-metrics#squarecloud-app-status)
* SDKs: [`api.apps.status()`](/en/sdks/js/managing_application) (JavaScript), [`client.apps.status()`](/en/sdks/py/managing_application) (Python), [`c.Apps.Status()`](/en/sdks/go/managing_application) (Go)


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