---
title: "List containers"
method: GET
path: "/container"
tags: ["Container"]
---

# List containers

`GET /container`

## Request

- Base URL: `https://sylve.lan:8181/api`
- URL: `https://sylve.lan:8181/api/container`
- Auth: API key in header `Authorization`

List containers with their live state

## Response `200`

Success

- GithubComAlchemillahqSylveInternalAPIResponseArrayGithubComAlchemillahqSylveInternalInterfacesServicesContainerListItem
  - `data` GithubComAlchemillahqSylveInternalInterfacesServicesContainerListItem[]
    - `annotations` object
    - `catalogApp` string
    - `command` string[]
    - `cores` integer
    - `createdAt` string
    - `creationPending` boolean
    - `description` string
    - `entrypoint` string[]
    - `env` GithubComAlchemillahqSylveInternalDbModelsContainerEnvVar[]
      - `name` string
      - `value` string
    - `extraHosts` string[]
    - `hostname` string
    - `id` integer
    - `image` string
    - `ip` string
    - `memory` integer
    - `mounts` GithubComAlchemillahqSylveInternalDbModelsContainerMount[]
      - `guid` string
      - `mode` string
      - `owner` string
      - `readOnly` boolean
      - `source` string
      - `target` string
      - `type` 'volume' | 'dataset' | 'path'
    - `name` string
    - `network` GithubComAlchemillahqSylveInternalDbModelsContainerNetwork
      - `bridge` string
      - `createdAt` string
      - `gateway` string
      - `id` integer
      - `name` string
      - `rangeEnd` string
      - `rangeStart` string
      - `subnet` string
      - `switchId` integer
      - `switchType` string
      - `updatedAt` string
    - `networkId` integer
    - `ocId` integer
    - `os` string
    - `pool` string
    - `ports` GithubComAlchemillahqSylveInternalDbModelsContainerPort[]
      - `containerPort` integer
      - `hostIp` string
      - `hostPort` integer
      - `protocol` string
    - `restart` string
    - `restartRetries` integer
    - `runtimeId` string
    - `shmSize` string
    - `stack` string
    - `startAtBoot` boolean
    - `startOrder` integer
    - `state` string
    - `stopTimeout` integer
    - `updatedAt` string
    - `user` string
    - `webHttps` boolean
    - `webPort` integer
    - `workDir` string
  - `error` string
  - `message` string
  - `status` string

## Changes

- **2026-11-03** `9565cdd0abf5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/alchemillahq/apis/sylve-api/changes/container/get.md)

---

[API](https://skmtc.dev/alchemillahq/apis/sylve-api.md) - [All operations](https://skmtc.dev/alchemillahq/apis/sylve-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alchemillahq/apis/sylve-api/revisions/9565cdd0abf5?raw)
