---
title: ecctl platform runner search
description: Performs advanced runner searching. Read more about Query DSL. ecctl platform runner - Manages platform runners. 
url: https://www.elastic.co/elastic/docs-builder/docs/3028/reference/ecctl/ecctl_platform_runner_search
products:
  - Elastic Cloud Control
applies_to:
  - Elastic Cloud Enterprise: Generally available
---

# ecctl platform runner search
Performs advanced runner searching.

## Synopsis

Read more about [Query DSL](https://docs-v3-preview.elastic.dev/elastic/docs-builder/docs/3028/reference/query-languages/querydsl).
```
ecctl platform runner search [flags]
```


## Options

```
  -f, --file string    JSON file that contains JSON-style domain-specific language query
  -h, --help           help for search
      --query string   Searches using a given JSON query
```


## Options inherited from parent commands

```
      --api-key string        API key to use to authenticate (If empty will look for EC_API_KEY environment variable)
      --config string         Config name, used to have multiple configs in $HOME/.ecctl/<env> (default "config")
      --force                 Do not ask for confirmation
      --format string         Formats the output using a Go template
      --host string           Base URL to use
      --insecure              Skips all TLS validation
      --message string        A message to set on cluster operation
      --output string         Output format [text|json] (default "text")
      --pass string           Password to use to authenticate (If empty will look for EC_PASS environment variable)
      --pprof                 Enables pprofing and saves the profile to pprof-20060102150405
  -q, --quiet                 Suppresses the configuration file used for the run, if any
      --region string         Elastic Cloud Hosted region
      --timeout duration      Timeout to use on all HTTP calls (default 30s)
      --trace                 Enables tracing saves the trace to trace-20060102150405
      --user string           Username to use to authenticate (If empty will look for EC_USER environment variable)
      --verbose               Enable verbose mode
      --verbose-credentials   When set, Authorization headers on the request/response trail will be displayed as plain text
      --verbose-file string   When set, the verbose request/response trail will be written to the defined file
```


## See also

- [ecctl platform runner](https://www.elastic.co/elastic/docs-builder/docs/3028/reference/ecctl/ecctl_platform_runner) - Manages platform runners