---
type: api
title: Get runners
description: Retrieves an overview of all runners.
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-enterprise/v4/operation/operation-get-runners
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/cloud-enterprise/v4/operation/operation-get-runners
products:
  - Elastic Cloud Enterprise
---

# Get runners

## Paths

- `GET` `/platform/infrastructure/runners`

- [Basic auth](/elastic/docs-builder/docs/4371/api/doc/cloud-enterprise/v4/authentication#basicauth)
- [Api key auth](/elastic/docs-builder/docs/4371/api/doc/cloud-enterprise/v4/authentication#apikey)

## Description

Retrieves an overview of all runners.

## Query String Parameters

- `q` (string)
  An optional query to filter runners by. Maps to an Elasticsearch query_string query.

## Response

An overview of all runners.

`application/json`

- `runners` ([] RunnerInfo)
  List of runners
  - `runner_id` (string)
    The runner identifier
  - `runner_name` (string)
    The runner name
  - `zone` (string)
    Identifier of the zone
  - `tags` (map string to string)
    Meta data of the runner, like image ID or processor architecture
  - `features` (map string to boolean)
    State of features of the runner
  - `build_info` ({} RunnerBuildInfo)
    - `commit_hash` (string)
      Git commit hash
    - `version` (string)
      Version of the runner artifact
  - `host_ip` (string)
    Host IP for the runner
  - `public_hostname` (string)
    Public hostname for the runner
  - `containers` ([] RunnerContainerInfo)
    Containers for the runner
    - `container_name` (string)
      Name of this container
    - `container_set_name` (string)
      Name of the container set for the container
  - `roles` ([] RunnerRoleInfo)
    Roles for the runner
    - `role_name` (string)
      Name of the role
  - `connected` (boolean)
    Specifies if the runner is connected
  - `healthy` (boolean)
    Specifies if the runner is healthy
  - `health_checks` ({} RunnerHealthChecks)
    The checks performed to determine if an runner is healthy or not.
    - `is_docker_healthy` (boolean)
      Check performed by the runner to figure out if docker is healthy
    - `is_connected_to_zk` (boolean)
      Whether the runner is connected to zk or not
    - `has_containers` (boolean)
      Whether the runner has containers that it manages
  - `region` (string)
    The region that this runner belongs to. Only populated in SaaS or federated ECE.
## Code Examples

#### Console

```console
GET /platform/infrastructure/runners
```

#### curl

```curl
curl -X GET "/platform/infrastructure/runners"
```