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

# Get Stack

> Returns one stack with its members, status, connections, memory total and the template it came from.

Returns a stack and everything in it: applications, databases and Blob folders, the connections between them, the status of the members added up and, when the stack came from a template, the template and version. Needs the `stacks:read` scope when called with an API key.

**stack\_id** `string` *required*

The stack ID.

**workspace\_id** `string`

The workspace the stack belongs to. Required for a workspace member acting on a stack they do not own; the owner may omit it.

### Response

**response** `object`

The stack.

**Toggle object**

**id** `string`

The stack ID.

**name** `string`

The stack name.

**description** `string | null`

Optional description, or `null`.

**network\_mode** `string`

How the members reach each other. The value is `public`: services use their public addresses and databases are reached with client certificates.

**owner\_id** `string`

The account that owns the stack.

**workspace\_id** `string | null`

The workspace the stack belongs to, or `null` when it belongs to you.

**members** `object[]`

The members. Each has `resource_type` (`application`, `database` or `blob`), `resource_id`, `name`, `status` (`null` for a Blob folder), `ram` in MB (`0` for a Blob folder), `service_key` (the service id in the template, `null` for a member you added), `database_type` (the engine of a database, otherwise `null`), `closed` (`true` for an application of a [closed template](https://docs.vertracloud.app/templates/use/closed-templates.md): its code is not accessible) and `blob`.

For a Blob member, `blob` has the folder `prefix`, `visibility` (`private` or `public`), `used_bytes` (or `null`) and `api_key_id`, the key the platform created for the stack and restricted to that folder. See [Add Blob Folder](https://docs.vertracloud.app/api-reference/endpoint/stacks/blob/create.md).

**status** `object`

Members online, offline and building, added up: `up`, `down`, `building` and `total` (the members that have a status).

**ram\_total** `integer`

Memory of every member, in MB.

**bindings** `object[]`

The connections between members. Each has `id`, `stack_id`, `app_id` (the application that receives the variables), exactly one of `database_id`, `blob_id` and `target_app_id`, `env_map` (variable name to what it receives), `certs_path` (the folder inside the application where the client certificates of a database are written, `null` without a database) and `created_at`. See [Create Connection](https://docs.vertracloud.app/api-reference/endpoint/stacks/bindings/create.md).

**template** `object | null`

The template and version the stack came from, or `null` for a stack assembled by hand. It has the same fields as the `template` of an [application](https://docs.vertracloud.app/api-reference/endpoint/apps/get.md), including `icon_url`, the stable URL of the template icon (`null` when there is none).

**update\_available** `boolean`

`true` when the template has a newer version the stack can update to.

**created\_at** `string`

When the stack was created.

**updated\_at** `string`

When the stack was last updated.

```json Response theme={null}
{
  "response": {
    "id": "stk-abc123def456",
    "name": "shop",
    "description": null,
    "network_mode": "public",
    "owner_id": "usr-abc123",
    "workspace_id": null,
    "members": [
      { "resource_type": "application", "resource_id": "app-abc123def456", "name": "web", "status": "up", "ram": 512, "service_key": null, "database_type": null, "closed": false, "blob": null },
      { "resource_type": "database", "resource_id": "db-abc123def456", "name": "main", "status": "up", "ram": 256, "service_key": null, "database_type": "postgres", "closed": false, "blob": null }
    ],
    "status": { "up": 2, "down": 0, "building": 0, "total": 2 },
    "ram_total": 768,
    "bindings": [
      {
        "id": "bnd-abc123def456",
        "stack_id": "stk-abc123def456",
        "app_id": "app-abc123def456",
        "database_id": "db-abc123def456",
        "blob_id": null,
        "target_app_id": null,
        "env_map": { "DATABASE_URL": "url" },
        "certs_path": "/app/.vertra/certs/db-abc123def456/",
        "created_at": "2026-10-27T12:00:00.000Z"
      }
    ],
    "template": null,
    "update_available": false,
    "created_at": "2026-10-27T12:00:00.000Z",
    "updated_at": "2026-10-27T12:00:00.000Z"
  }
}
```

### Errors

| Status | Code | When |
| - | - | - |
| 403 | `API_KEY_SCOPE_DENIED` | The key does not have `stacks:read`. |
| 404 | `STACK_NOT_FOUND` | The stack does not exist or belongs to another account. |


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