---
title: "Get process status"
method: GET
path: "/browsers/{id_or_name}/process/{process_id}/status"
tags: ["Browser Processes"]
---

# Get process status

`GET /browsers/{id_or_name}/process/{process_id}/status`

## Request

- Base URL: `https://api.onkernel.com`
- URL: `https://api.onkernel.com/browsers/{id_or_name}/process/{process_id}/status`
- Auth: HTTP bearer

## Path parameters

- `id_or_name` string, required
- `process_id` string, uuid, required

## Response `200`

Status

- ProcessStatus: Current status of a process.
  - `cpu_pct` number: Estimated CPU usage percentage.
  - `exit_code` integer, nullable: Exit code if the process has exited.
  - `mem_bytes` integer: Estimated resident memory usage in bytes.
  - `state` 'running' | 'exited': Process state.

## Other responses

- `400`: Bad Request – invalid input
- `404`: Resource not found
- `500`: Internal Server Error
- `default`: Error returned by the browser or its proxy

---

[API](https://skmtc.dev/onkernel/apis/kernel-api.md) - [All operations](https://skmtc.dev/onkernel/apis/kernel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/onkernel/apis/kernel-api/revisions/0f6cf4f58fe6?raw)
