---
title: "Get application information"
method: GET
path: "/v2/apps/{appId}"
tags: ["Lifecycle"]
---

# Get application information

`GET /v2/apps/{appId}`

Returns the application's identity, plan, region, language, and DNS configuration. The response is scoped to the caller; access to workspace-shared applications is granted automatically when the caller is a member of the owning workspace.

## Path parameters

- `appId` string, required

## Response `200`

Application metadata.

- object
  - `status` 'success', required
  - `response` App, required
    - `id` string, required — 24-char hex application identifier.
    - `name` string, required — Display name.
    - `desc` string — Optional free-form description. Key is omitted when not set.
    - `owner` string, required — User identifier of the application owner.
    - `cluster` string, required — Cluster identifier the application is hosted on.
    - `ram` integer, required — Allocated memory in MB.
    - `language` string, required — Runtime language slug. One of `javascript`, `typescript`, `python`, `java`, `elixir`, `go`, `rust`, `php`, `dotnet`, `static`.
    - `domain` string, nullable, required — Default `<subdomain>.squareweb.app` hostname. `null` for non-web apps.
    - `custom` string, nullable, required — Custom domain bound to the app, when configured.
    - `created_at` string, date-time, required

## Other responses

- `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 authenticated user or API key exceeded the global request budget.
- `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)