Skip to main content
GET
/
runners
/
List Runners
curl --request GET \
  --url https://rest.alpha.fal.ai/runners/
{
  "runners": [
    {
      "runner_id": "b9a2835f-12c7-48d1-b48a-50064218cb0c",
      "application": "test-long-startup-app",
      "state": "RUNNING",
      "machine_type": "S",
      "region": "us-east",
      "node_id": "fcf7db39-7326-3cdf-103c-8191fd345745",
      "started_at": "2025-09-18T18:05:42+00:00",
      "finished_at": null,
      "owner": "github|5367102",
      "cpu_usage_percent": null,
      "memory_usage_bytes": null,
      "vram_usage_ratio": null
    },
    {
      "runner_id": "41512b2d-d821-4d62-a98b-9472c9d43941",
      "application": "test-startup-timeout",
      "state": "dead",
      "machine_type": "S",
      "region": "",
      "node_id": "",
      "started_at": "2025-09-19T12:05:40.729467+00:00",
      "finished_at": "2025-09-19T12:16:11.238922+00:00",
      "owner": "github|5367102",
      "cpu_usage_percent": null,
      "memory_usage_bytes": null,
      "vram_usage_ratio": null
    },
    {
      "runner_id": "e0a4c199-863c-481e-9a7e-008391e079b9",
      "application": "test-startup-timeout",
      "state": "PENDING",
      "machine_type": "S",
      "region": "pending",
      "node_id": "pending",
      "started_at": null,
      "finished_at": null,
      "owner": "github|5367102",
      "cpu_usage_percent": null,
      "memory_usage_bytes": null,
      "vram_usage_ratio": null
    }
  ]
}
Query Parameters:
​
start_time
datetime
Include runners that were active after this time
​
end_time
datetime
Include runners that were active before this time
​
application
string
Filter by application name (case-insensitive)
{
  "runners": [
    {
      "runner_id": "b9a2835f-12c7-48d1-b48a-50064218cb0c",
      "application": "test-long-startup-app",
      "state": "RUNNING",
      "machine_type": "S",
      "region": "us-east",
      "node_id": "fcf7db39-7326-3cdf-103c-8191fd345745",
      "started_at": "2025-09-18T18:05:42+00:00",
      "finished_at": null,
      "owner": "github|5367102",
      "cpu_usage_percent": null,
      "memory_usage_bytes": null,
      "vram_usage_ratio": null
    },
    {
      "runner_id": "41512b2d-d821-4d62-a98b-9472c9d43941",
      "application": "test-startup-timeout",
      "state": "dead",
      "machine_type": "S",
      "region": "",
      "node_id": "",
      "started_at": "2025-09-19T12:05:40.729467+00:00",
      "finished_at": "2025-09-19T12:16:11.238922+00:00",
      "owner": "github|5367102",
      "cpu_usage_percent": null,
      "memory_usage_bytes": null,
      "vram_usage_ratio": null
    },
    {
      "runner_id": "e0a4c199-863c-481e-9a7e-008391e079b9",
      "application": "test-startup-timeout",
      "state": "PENDING",
      "machine_type": "S",
      "region": "pending",
      "node_id": "pending",
      "started_at": null,
      "finished_at": null,
      "owner": "github|5367102",
      "cpu_usage_percent": null,
      "memory_usage_bytes": null,
      "vram_usage_ratio": null
    }
  ]
}
⌘I