---
type: api
title: Get runner
description: Retrieves a runner by id.
url: https://www.elastic.co/elastic/docs-builder/docs/4641/api/doc/cloud-enterprise/v4/operation/operation-get-runner
resource: https://www.elastic.co/elastic/docs-builder/docs/4641/api/doc/cloud-enterprise/v4/operation/operation-get-runner
products:
  - Elastic Cloud Enterprise
---

# Get runner

Authentication: required

## Paths

- `GET` `/platform/infrastructure/runners/{runner_id}`

#### Path parameters

- `runner_id` (string) — required
  The identifier for the runner

## Description

Retrieves a runner by id.

## Responses

#### `200`

The information for the runner specified by {runner_id}.

`application/json`

- `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.
#### `404`

Unable to find the {runner_id} specified runner. Edit your request, then try again. (code: `runners.runner_not_found`)

`application/json`

- `errors` (object[])
  A list of errors that occurred in the failing request
  - `code` (string)
    A structured code representing the error type that occurred
  - `message` (string)
    A human readable message describing the error that occurred
  - `fields` (string[])
    If the error can be tied to a specific field or fields in the user request, this lists those fields
##### Response headers

- `x-cloud-error-codes` (enum)
  The error codes associated with the response

## Code examples

#### curl

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

## Response examples

#### 200

`application/json`

Generated from the API spec. Values are representative. Unions use the first variant; deeply nested or large bodies may omit fields.

```json
{
  "runner_id": "string",
  "runner_name": "string",
  "zone": "string",
  "tags": {
    "key": "string"
  },
  "features": {
    "key": false
  },
  "build_info": {
    "commit_hash": "string",
    "version": "string"
  },
  "host_ip": "string",
  "public_hostname": "string",
  "containers": [
    {
      "container_name": "string",
      "container_set_name": "string"
    }
  ],
  "roles": [
    {
      "role_name": "string"
    }
  ],
  "connected": false,
  "healthy": false,
  "health_checks": {
    "is_docker_healthy": false,
    "is_connected_to_zk": false,
    "has_containers": false
  },
  "region": "string"
}
```

#### 404

`application/json`

Generated from the API spec. Values are representative. Unions use the first variant; deeply nested or large bodies may omit fields.

```json
{
  "errors": [
    {
      "code": "string",
      "message": "string",
      "fields": [
        "string"
      ]
    }
  ]
}
```