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

# All applications status

> Get the live CPU, RAM and running state of every application you own with GET /v2/apps/status. Pass workspaceId to list a workspace's apps instead.

<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 live CPU, RAM, and running state for every application you own in a single call, which is more efficient than looping over [Get Application Status](/en/api-reference/endpoint/apps/status) once per application. Pass `workspaceId` to scope the listing to a shared workspace instead of your own applications; the caller must be the workspace owner or a member.

This is the endpoint the dashboard's applications overview polls. It is rate limited to 15 requests every 60 seconds per user; the equivalent per-application endpoint has its own, separate limits. For continuous updates instead of polling, open a [Real-time Logs](/en/api-reference/endpoint/apps/realtime) connection per application.

## Parameters

<ParamField query="workspaceId" type="string" placeholder="Workspace Id">
  A workspace id. You can found it below your workspace name on dashboard.
</ParamField>

If `workspaceId` isn't provided, will get your account applications status.

## 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="id" type="string">
      The application ID.
    </ResponseField>

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

    <ResponseField name="ram" type="string">
      The RAM usage of the application.
    </ResponseField>

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

<ResponseExample>
  ```json theme={"system"}
  {
    "status": "success",
    "response": [
      {
        "id": "5bbd020126ee4692aga43e0ca0a75454",
        "cpu": "0.00%",
        "ram": "55.88MB",
        "running": true
      },
      {
        "id": "e1b286ba30f14a87baed4b4ad3b53c47",
        "cpu": "0.01%",
        "ram": "68.44MB",
        "running": true
      }
    ]
  }
  ```
</ResponseExample>

## Common errors

| Code | HTTP | Meaning |
| - | - | - |
| `WORKSPACE_NOT_FOUND` | 404 | The `workspaceId` does not exist or the caller is not the owner or a member. |

## Related

* SDKs: [`api.apps.statusAll()`](/en/sdks/js/managing_application) (JavaScript), [`client.apps.status_all()`](/en/sdks/py/managing_application) (Python), [`c.Apps.StatusAll()`](/en/sdks/go/managing_application) (Go)


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