---
title: "Get project list"
method: GET
path: "/api/vps/v1/virtual-machines/{virtualMachineId}/docker"
tags: ["VPS: Docker Manager"]
---

# Get project list

`GET /api/vps/v1/virtual-machines/{virtualMachineId}/docker`

Retrieves a list of all Docker Compose projects currently deployed on the virtual machine. 

This endpoint returns basic information about each project including name,
status, file path and list of containers with details about their names,
image, status, health and ports. Container stats are omitted in this
endpoint. If you need to get detailed information about container with
stats included, use the `Get project containers` endpoint.

Use this to get an overview of all Docker projects on your VPS instance.

## Path parameters

- `virtualMachineId` integer, required

## Response `200`

Success response

- VPSV1DockerManagerProjectResource[] — Array of [`VPS.V1.DockerManager.ProjectResource`](#model/vpsv1dockermanagerprojectresource)
  - `name` string — Docker Compose project name (derived from directory name or compose file)
  - `status` string — Raw output from docker compose ps command showing service count and states
  - `state` 'running' | 'stopped' | 'created' | 'mixed' | 'unknown' — Derived project state parsed from the raw docker compose status
  - `path` string — Full filesystem path to the docker-compose.yml file
  - `containers` VPSV1DockerManagerContainerResource[] — Array of [`VPS.V1.DockerManager.ContainerResource`](#model/vpsv1dockermanagercontainerresource)
    - `id` string — Unique container identifier (short form of Docker container ID)
    - `name` string — Container name as defined in docker-compose or assigned by Docker
    - `image` string — Docker image name and tag used to create this container
    - `command` string — Command being executed inside the container (may be truncated with ...)
    - `status` string — Human-readable container status including uptime, exit codes, or error information
    - `state` 'created' | 'running' | 'restarting' | 'exited' | 'paused' | 'dead' | 'stopping' — Programmatic container lifecycle state for automated processing
    - `health` 'starting' | 'healthy' | 'unhealthy' | '' — Container health status
    - `ports` VPSV1DockerManagerContainerPortResource[] — Array of [`VPS.V1.DockerManager.ContainerPortResource`](#model/vpsv1dockermanagercontainerportresource)
      - `type` 'published' | 'published_range' | 'exposed' | 'exposed_range' — Port mapping type - published (accessible from host), exposed (only internal), or range variants
      - `protocol` 'tcp' | 'udp' — Network protocol used for communication
      - `host_ip` string, nullable — IP address on host where port is bound (null for exposed-only ports)
      - `host_port` integer, nullable — Port number on host machine (null for exposed-only or range ports)
      - `container_port` integer, nullable — Port number inside container (null for range ports)
      - `host_port_start` integer, nullable — Starting port number in host port range (null for single ports)
      - `host_port_end` integer, nullable — Ending port number in host port range (null for single ports)
      - `container_port_start` integer, nullable — Starting port number in container port range (null for single ports)
      - `container_port_end` integer, nullable — Ending port number in container port range (null for single ports)
    - `stats` VPSV1DockerManagerContainerStatsResource
      - `cpu_percentage` number, float — CPU usage in percentage
      - `memory_percentage` number, float — Memory usage in percentage
      - `memory_used` number, float — Used memory in bytes
      - `memory_total` number, float — Total available memory in bytes
      - `net_in` integer — Inbound network traffic in bytes
      - `net_out` integer — Outbound network traffic in bytes

## Other responses

- `401` — Unauthenticated response
- `422` — Validation error response
- `500` — Error response

---

[API](https://skmtc.net/hostinger/apis/hostinger-api.md) · [All operations](https://skmtc.net/hostinger/apis/hostinger-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hostinger/hostinger-api/versions/796bd5194565/schema)