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

# Get runners

## Paths

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

## Description

Retrieves an overview of all runners.

## Authentication

- Basic: `Authorization: Basic <credentials>`
- Api key: `Authorization: <value>`

## Query string parameters

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

## Response

An overview of all runners.

`application/json`

- `runners` (object[])
  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` (object)
    - `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` (object[])
    Containers for the runner
    - `container_name` (string)
      Name of this container
    - `container_set_name` (string)
      Name of the container set for the container
  - `roles` (object[])
    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` (object)
    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

#### curl

```curl
curl -X GET "${API_URL}/platform/infrastructure/runners" \
  -u "${USERNAME}:${PASSWORD}"
```