---
title: "GET /api/kernel/status"
method: GET
path: "/api/kernel/status"
---

# GET /api/kernel/status

`GET /api/kernel/status`

## Headers

- `Marimo-Session-Id` string, required

## Response `200`

Report whether the kernel is currently executing. `running` means at least one cell is queued or running; `idle` means the kernel is alive but not executing; `stopped` means the kernel process is not running.

- KernelStatusResponse
  - `state` 'idle' | 'running' | 'stopped', required

## Changes

> 60 revisions in range; 2 could not be searched.

- **2026-06-02** `26c268dbb9f7` — 1 info
  - endpoint added
- **2026-03-18** `f29fa637d35b` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/marimo-team/apis/marimo-api/changes/api/kernel/status/get.md)

---

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