> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hopx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List System Processes

> List all running system processes in the sandbox using the HopX VM Agent API. View all system processes including background executions, system services, and user processes. Learn how to use GET /processes/system endpoint to monitor system activity and debug process issues. Includes request examples and process information.

List all running system processes in the sandbox with PID, command, and user information.

## Endpoint

```
GET /processes
```

## Request

### Headers

```
Authorization: Bearer YOUR_JWT_TOKEN
```

### Example Request

```bash theme={null}
curl https://sandbox_abc123xyz.hopx.dev/processes \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"
```

## Response

### Success (200 OK)

```json theme={null}
{
  "processes": [
    {
      "pid": 1,
      "command": "/usr/bin/python3 /app/agent.py",
      "user": "root"
    },
    {
      "pid": 123,
      "command": "python -m http.server 8000",
      "user": "user"
    }
  ],
  "count": 2
}
```

## Status Codes

| Code | Description  |
| ---- | ------------ |
| 200  | Success      |
| 401  | Unauthorized |

## Use Cases

### Find Specific Process

```bash theme={null}
curl https://sandbox_abc123xyz.hopx.dev/processes \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" | \
  jq '.processes[] | select(.command | contains("python"))'
```

### Count Processes

```bash theme={null}
curl https://sandbox_abc123xyz.hopx.dev/processes \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" | jq '.count'
```

## Related

* **[Process Monitoring](/core-concepts/observability/processes)** - Learn about process monitoring
* **[List Background Processes](/api/vm-agent/list-processes)** - View background execution processes
* **[Get System Metrics](/api/vm-agent/get-system-metrics)** - View resource usage
* **SDK**: [sandbox.list\_system\_processes()](/sdk/python/sandbox#list_system_processes) - Python SDK method
* [CLI System Commands](/cli/commands/system) - System operations from CLI

## Next Steps

* **[Get System Metrics](/api/vm-agent/get-system-metrics)** - View resource usage
* **[List Background Processes](/api/vm-agent/list-processes)** - View background execution processes