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

# Get project containers

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

Retrieves a list of all containers belonging to a specific Docker Compose project on the virtual machine. 

This endpoint returns detailed information about each container including
their current status, port mappings, and runtime configuration.

Use this to monitor the health and state of all services within your Docker Compose project.

## Path parameters

- `virtualMachineId` integer, required
- `projectName` string, required

## Response `200`

Success response

- 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.dev/hostinger/apis/hostinger-api.md) · [All operations](https://skmtc.dev/hostinger/apis/hostinger-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hostinger/hostinger-api/revisions/53ccee45e5eb/schema)