Skip to main content
GET
/
processes
List processes
curl --request GET \
  --url http://localhost:7687/processes
{
  "processes": [
    {
      "pid": 1,
      "state": "idle",
      "status": "success"
    },
    {
      "pid": 2,
      "state": "running",
      "status": null
    },
    {
      "pid": 3,
      "state": "queued",
      "status": null
    }
  ]
}

Query Parameters

​
state
enum<string>

Filter processes by life-cycle state. Where the process is in its life-cycle.

Available options:
queued,
running,
idle
​
status
enum<string> | null

Filter processes by execution outcome. The outcome of execution.

Available options:
success,
failed,
canceled,
null
​
ref
string

Filter processes by reference.

Response

List of processes (may be empty).

​
processes
object[]
required

The matching processes. Empty array if none match the filters.

Last modified on March 18, 2026