---
title: "List Processes"
method: GET
path: "/apps/{app_name}/machines/{machine_id}/ps"
tags: ["Machines"]
---

# List Processes

`GET /apps/{app_name}/machines/{machine_id}/ps`

List all processes running on a specific Machine within an app, with optional sorting parameters.

## Path parameters

- `app_name` string, required
- `machine_id` string, required

## Query parameters

- `sort_by` string
- `order` string

## Response `200`

OK

- ProcessStat[]
  - `command` string
  - `cpu` integer
  - `directory` string
  - `listen_sockets` ListenSocket[]
    - `address` string
    - `proto` string
  - `pid` integer
  - `rss` integer
  - `rtime` integer
  - `stime` integer

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/fly/apis/machines-api.md) · [All operations](https://skmtc.dev/fly/apis/machines-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fly/machines-api/revisions/f5ad396d55d7/schema)