---
title: "GET /containers/{id}/top"
method: GET
path: "/containers/{id}/top"
---

# GET /containers/{id}/top

`GET /containers/{id}/top`

List processes running inside a container

## Path parameters

- `id` string, required

## Query parameters

- `ps_args` string

## Response `200`

The request has succeeded.

- ContainerTopResponse — Container "top" response.
  - `Titles` string[] — The ps column titles
  - `Processes` array[] — Each process running in the container, where each process is an array of values corresponding to the titles.
    - string[]

## Changes

- **2026-02-14** `31f80d10d31a` — 1 breaking, 3 info
  - for the `query` request parameter `ps_args`, default value `-ef` was removed
  - api tag `Container` removed
  - removed the non-success response with the status `404`
  - removed the non-success response with the status `500`

[Change history](https://skmtc.dev/hexlet/apis/docker-engine-api/changes/containers/:id/top/get.md)

---

[API](https://skmtc.dev/hexlet/apis/docker-engine-api.md) · [All operations](https://skmtc.dev/hexlet/apis/docker-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hexlet/docker-engine-api/revisions/7dbd508c79cf/schema)